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PREFACE 



This manual describes how the ISIS-II user who is familiar with 8080/8085 assembly 
language can convert 8080/8085 source files to 8086 assembly language source files, 
which can then be assembled, linked, located, and run to perform their equivalent 
8080/8085 functions on the upwardly compatible, 16-bit 8086. 

Chapter 1 describes the scope and environment of conversion. 

Chapter 2 describes how to operate the converter program CONV86. 

Chapter 3 describes how to edit converter output to obtain MCS-86 source files. 

Appendices describe the instruction, operand (expression), and directive mappings; 
reserved names; and sample conversions with 8080/8085 and MCS-86 Macro 
Assembler listings of source and output files. 

The following publications contain detailed information on 8080/8085 and MCS-86 
software related to this manual: 

• 8080/8085 Assembly Language Programming Manual, Order No. 9800301 

• 75/5-/7 8080/8085 Macro Assembler Operator's Manual, Order No. 9800292 

• ISIS-II User's Guide, Order No. 9800306 

• 8086 Family User's Manual Order No. 9800722 

• MCS-86™ Macro Assembly Language Reference Manual, Order No. 9800640 

• MCS-86™ Macro Assembler Operating Instructions for ISIS-II Users, Order 
No. 9800641 

• MCS-86™ Software Development Utilities Operating Instructions for ISIS-II 
Users, Order No. 9800639 

• ISIS-II PL/M-86 Compiler Operator's Manual, Order No. 9800478 
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CHAPTER 1 
AN OVERVIEW OF CONVERSION 



Conversion and You 

What Is Conversion? 

Conversion is a way for you to obtain MCS-86 source files from your error-free 
8080/8085 assembly-language source files. (Recall that an assembly-language source 
file consists of assembler control statements, assembler directives, and assembly- 
language instructions.) 

Figure 1-1 shows the role of conversion in 8080/8085-to-8086 software development. 
Conversion consists of two phases: 

1. Operating the program CONV86 under ISIS-II. As shown in Figure 1-2, 
CONV86 accepts as input an error-free 8080/8085 assembly-language source 
file and optional controls, and produces as output optional PRINT and OUT- 
PUT files. The OUTPUT file contains machine-readable 8086 assembly- 
language source code generated by CONV86. The PRINT file is human- 
readable and contains: 

• Input 8080/8085 assembly-language source code — optionally controlled by 
SOURCELIST/NOSOURCELIST converter control 

• Output 8086 assembly-language source code with embedded diagnostic 
("caution") messages 

Chapter 2 describes how to operate CONV86 under ISIS-II. 

2. Manually editing (using the ISIS-II text editor) the OUTPUT file as indicated by 
the caution messages in the PRINT file. Chapter 3 describes how to edit 
CONV86 output according to the caution messages generated. Some machine- 
dependent sequences (such as software timing delays) are not detected by 
CONV86, but still require manual editing. Recall that in going from the 8080 to 
the 8086, both the instruction size (length) and time (clocks) change. 

Figure 1-1 shows both phases of conversion, as well as subsequent assembling, link- 
ing, and (absolute) loading required for execution of your program. 

Figure 1-3 shows the format of the PRINT file, and highlights features of conver- 
sion discussed here and elsewhere in this manual. 

Why Convert? 

If you want to capitalize on your software investment in the 8080/8085, and if your 
8080/8085 source files are tried-and-true, then conversion may offer you a con- 
siderable head-start in your software development effort for the upwardly- 
compatible 8086. 



What Preparation Does CONV86 Require of Source Code? 

You must ensure that all 8080/8085 source files to be converted can be assembled 
without error by the ISIS-II 8080/8085 assembler. No source line can be longer than 
129 characters, excluding carriage-return and line-feed. If your program contains 
more than 600 symbols, you must break your program down into smaller programs 
(even if you have 64K RAM). 
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Figure 1-1 . From 8080/8085 Assembly Language Source File to 8086 Execution 
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Figure 1-2. CONV86 Input and Output Files 
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What About Macros? 

All macro definitions and calls will be converted to their 8086 equivalents. However, 
macro-related constructs require special conversion. Appendix E lists all of these 
constructs and shows how they are mapped. 



NOTE 

ASM86 may misinterpret metacharacters (%) or unmatched parentheses 
appearing in comments as macro invocations. 



What Hardware/Software Is Needed for Conversion ? 

You need an Intellec microcomputer development system with 64K bytes of RAM 
and at least one diskette unit. The CONV86 program occupies a single diskette and 
runs under ISIS-II. During execution, CONV86 creates a work file (CONV86.TMP) 
which requires seven bytes for each line of 8080/8085 code processed. Upon normal 
termination, CONV86 deletes this temporary file. 



How Much Manual Editing of CONV86 Output Is Necessary? 

Anywhere from none to a considerable amount, depending on the nature of the 
8080/8085 source file. In general, the following kinds of source code are better 
implemented on the 8086 by recoding from scratch in 8086 assembly language, 
rather than by converting from 8080: 

• "Tricky' ' code that modifies itself 

• Code that uses operation mnemonics as operands (for example, the instruction 
MVI C,(MOV A,B); the intent of this instruction is to load C with the opcode 
forMOVA,B). 

• Programs relying heavily on the 8085 instructions RIM and SIM (Read/Set 
Interrupt Mask) should be recoded from scratch in 8086 rather than converted. 
The 8086 has no functional counterparts for these instructions. 

It is therefore recommended that source files not be blindly submitted for conver- 
sion. Each source file under consideration for conversion should be carefully 
examined for these problem areas. 



What Advantage Is There in Rewriting Programs in 8086 Assembly Language 
Rather Than Converting? 

CONV86 converts most 8080/8085 assembly-language source programs adequately. 
You can take advantage of the more powerful 8086 by coding some routines directly 
in 8086 assembly language. 

For example, Figure 1-4 shows assembled program listings for: 

• 8080 Assembly of BCDBIN (13 bytes 8080 object code) 

• MCS-86 Assembly of Conversion of BCDBIN (22 bytes 8086 object code) 

• MCS-86 Assembly of BCDMCS Original 8086 Source (7 bytes 8086 object code) 
(Recall that the PRINT file for the conversion of BCDBIN is shown in Figure 1-3.) 
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CONV86 



^CONVERTER PRINT File, :F1:BCDBIN.CNV I 



ASM80 TO ASM36 CONVERTER |BCD-TO-BINARY ROUTINE [ ■ 



ISIS-II A3M33 TO ASM35 conversi on of 
USW85 PLACED IN : F1:BCDBIN.S8SI 
CONVERTER V2.0 INVOKED BY : 



Title from Invoking Command J 



?1 : BCDBIN.S30 




CONV86 :F1:BCDBIN.S30 k 3083 SOURCE FILE — 
PRINT: :F1:BC0BI8.CNV) i CONVERSION AND CAUTIONS 
OUTPUT!: F1:BCDBIN.S35) 4 3035 CODS GENERATED 

TITLEl'BCD-TO-BINARY ROUTINE") 1 MAX 39 CHARS 

APPROX 4 DON'T CARE ABOUT FLAG SEMANTICS FOR THIS 
ABS 4 DON'T CARE ABOUT RSLOCATABIL I I Y OR PL/M FOR 



8080 PROGRAM 



Invoking Command J 



( Copy of Source File) 

T 



r\ 



W 



T 



THIS ROUTINE CONVERTS BCD TO BINARY AS FOLLOWS: 

BCD TEN'S DIGIT IN LOW NIBBLE OF B REG. 

BCD UNIT'S DIGIT IN LOW NIBBLE OF C RE3. 

HIGH NIBBLES OF B AND C ASSUMED TO BE IRRELEVANT. 

BINARY RESULT 10-99) IS LEFT IN ACCUMULATOR. 
ORG 43O0H 

;UHIT'S DIGIT 4 GARBAGE TO ACC. 
;MASS OUT GARBAGE 
;SAVS UNIT'S DIGIT IN E lLOW) 
;TSN*S DIGIT i GARBAGE TO ACC. 
;MASrC OUT 3ARBAG 



BCD BIN: 



MOV 
AN I 
MOV 
MOV 
AN I 
MOV 
RLC 
RLC 
ADD 
RLC 
ADD 
END 



A,C 
3FH 
S, A 
A,B 
OFH 
D,A 



;SAVE TEN'S DIGIT IN D I LOW) 

;2»TEN' S 

; 1»TEN' S 

; 5»TSN' S 

; 13»TEN'S 

;10»rSN*S ^ UNIT'S BIN. REP. IN ACC. 



These headings identify the source 
and output program listings in the 
PRINT file. If the NOSOURCELIST 
control is in effect, the source 
program does not appear in the 
PRINT file. 




k 



ASM33 TO A3M3J CONVERTER |3CD- TO- BI ,<AR Y ROUTINE] * 




,3335 PROGRAM 



M LABEL BYTE 

,i»DSFINS [REPT IS) LOCALS I BO*)) LOCAL MACRO 
I»DEFINE IMACRO) LOCA L\ JLOCAL S IJBODY) 
{REPEAT UN) I IMACRO) 
J*DEFINS :iRP IPARM.PLIST) LOC/Ls IBODY)) LOCAL MACRO LIST I 
{•DEFINE I MACRO) LOCAL ULOCALS IJBODY) 
J»DEFINS ILIST) IJPLISTJ 
tIF I SLSNl J*LIST) EQ 01 THEN 
{DEFINE I tPARM) \I 13) 
IMACRO ) 
SLSE I 

JWHIlS I!LENU»LlST) NS 0) 

JMATCHl 1<\aRM,LIST) Il»LIST) 
IMACRO ) 
FI ) 

{•DEFINE IIRPC IPARM.TEXT) L OC AL3 II BODY ) ) LOCAL MACRO LIST 
{•DEFINE IMACRO) LOCAL ILCJCALS '.{BODY) 
('DEFINE' I LIST) I {TEXT) 
{IF I 1LENI J»LIST) EQ 0) T^EN I 
{DEFINE IJPARM) 
{MACRO ) 
ELSE I 

xwaiLS I ilen: t«Lisr» «e 3) 

{DEFINE Ii?lR,4) I I»SUBSTRU»L 1ST, 
{DEFINE ILI^T) I I ' SUBS TRl { >L I ST, 
IMACRO ) ) 

L1_L 



THIS ROUTINE CONVERTS BCD TO 3I:URY\ 
3CD TEN'S DIGIT IN LOW NIBBLE Of 
BCD UNIT'S DIGIT IN LOW NIBBLE 
HIGH NIBBlSS OF B AND C ASSUMED 
S JLT 13-99 ) IS 
1003H 

Al ,Cl 

AL , 3FH | 
DL , AL 



FOLLOWS: 



GARBAGE 13 ACC. 




Figure 1-3. Sample PRINT File 
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ASM80 : F1 :BCDBI.N.S30 

ISIS-II 3080/3035 MACRO ASSEMBLER, 1/2.0 



MODULE PA3 



LOC OBJ 



SEQ SOURCE STATEMENT 



THIS ROUTINE CONVERTS BCD TO BINARY A3 FOLLOWS: 
BCD TEH'S DIGIT IS VOW NIBBLE OF B REG. 
BCD UNIT'S DIGIT IN '.OB NIBBLE OF C REG. 
HIGH NIBBLES OF B AND C ASSUMED TO BE IRRElEVANT. 
BINARY RESULT 10-99) IS LEFT IN ACCUMULATOR. 

UNIT'S DIGIT 1 GARBAGE TO ACC 
MASS OUT GARBAGE 
SAVE UNIT'S DIGIT IS E ILOW) 
TEN'S DIGIT 4 GARBAGE TO ACC. 
MASK OUT GARBAGE 
SAVE TEN'S DIGIT IN 
2»TEN' S 
4»TEN' S 
5»T£iN* S 
10*TEN" S 

10»TSN" S * UNIT' S B 
END 



4000 
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ORG 
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4000 
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7 BCDBIN: 


mov 
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£5 Of 
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ANI 


OFH 
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5F 


9 


MOV 


E, A 


4004 
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10 


MOV 
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MOV 
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PUBLIC SYMBOLS 



externa:. SYMBOLS 



USER SYMBO.S 
BCDBIN A 4000 



ASSEMB.Y COMPLETE, NO ERRORS 




MCS-86 MACRO ASSEMBLER 
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ASSEMBLY COUPLETS, NO ERRORS FOUND 
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Figure 1-4. Program Listings: Original 8080 (top); Converted 8080 (middle) 
Original 8086 (bottom) 
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Functional Mapping 

What Are the 8086 Assembly Language Prologues Generated by CONV86? 

The main source file of your 8080/8085 program should be converted using the 
(defaulted) control NOTINCLUDED. If NOTINCLUDED is in effect, the con- 
verted file begins with a converter-generated prologue. The prologue generated by 
the converter depends on whether the ABS or REL control is specified when 
CONV86 is run (REL is the default). 

If the ABS control is specified (for subsequent absolute loading by 8086 relocation 
and linkage), CONV86 generates as a prologue: 



ASSUME DS:ABS_0,CS:ABS_0 
ABS_0 SEGMENT BYTE AT 
M LABEL BYTE 

%* DEFINE (REPT (N) LOCALS (BODY)) LOCAL MACRO ( 

%*DEFINE (MACRO) LOCAL %LOCALS (%BODY) 
%REPEAT (%N) (%MACRO) ) 
%*DEFINE (IRP (PARM,PLIST) LOCALS (BODY)) LOCAL MACRO LIST ( 
%*DEFINE (MACRO) LOCAL %LOCALS (%BODY) 
%* DEFINE (LIST) (%PLIST) 
%IF (%LEN(%*LIST) EQ 0) THEN ( 
%DEFINE (%PARM) (%0) 
% MACRO) 
ELSE( 

%WHILE (%LEN(%*LIST) NE 0) ( 

%MATCH(%PARM,LIST) (%*LIST) 
%MACRO ) ) 
Fl) 
%*DEFINE (IRPC (PARMJEXT) LOCALS (BODY)) LOCAL MACRO LIST ( 
%*DEFINE (MACRO) LOCAL %LOCALS (%BODY) 
%*DEFINE (LIST) (%TEXT) 
%IF (%LEN(%*LIST) EQ 0) THEN ( 
%DEFINE (%PARM) (%0) 
% MACRO) 
ELSE( 

%WHILE (%LEN(%*LIST) NE 0) ( 

%DEFINE (%PARM) (%*SUBSTR(%*LIST,1,1)) 
%DEFINE (LIST) (%*SUBSTR(%*LIST,2,9999)) 
%MACRO)) 
Fl) 

If the REL control is specified (for converting 8080/8085 source files with 
relocatability features, and/or for subsequent linking to PL/M-86 modules) 
CONV86 generates as a prologue: 



ABS_0,CODE,CONST,DATA,STACK, MEMORY 
ABS__0,CODE,CONST,DATA,STACK, MEMORY 
DS:DGROUP,CS:CGROUP,SS:DGROUP 
WORD PUBLIC 'CODE' 

WORD PUBLIC 'CONST' 

WORD PUBLIC 'DATA' 

WORD STACK 'STACK' 
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CGROUP 


GROUP t 


DGROUP 


GROUP i 




ASSUME 1 


CODE 


SEGMENT ^ 


CODE 


ENDS 


CONST 


SEGMENT \ 


CONST 


ENDS 


DATA 


SEGMENT ) 


DATA 


ENDS 


STACK 


SEGMENT \ 




DB n DUP(?) 
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STACK_BASE LABEL 


BYTE 


STACK ENDS 




MEMORY SEGMENT 


WORD MEMORY 'MEMORY' 


MEMORY_ LABEL 


BYTE 


MEMORY ENDS 




ABS_0 SEGMENT 


BYTE AT 


M LABEL 


BYTE 



%*DEFINE (REPT (N) LOCALS (BODY)) LOCAL MACRO ( 

%*DEFINE (MACRO) LOCAL %LOCALS (%BODY) 
%REPEAT (%N) (%MACRO) ) 
%*DEFINE (IRP (PARM,PLIST) LOCALS (BODY)) LOCAL MACRO LIST ( 
%*DEFINE (MACRO) LOCAL %LOCALS (%BODY) 
%*DEFINE (LIST) (%PLIST) 
%IF(%LEN(%*LIST) EQ0)THEN ( 
%DEFINE (%PARM) (%0) 
%MACRO ) 
ELSE( 

%WHILE (%LEN(%*LIST) NE 0) ( 

%MATCH(%PARM,LIST) (%*LIST) 
% MACRO ) ) 
Fl) 
%*DEFINE (IRPC (PARMJEXT) LOCALS (BODY)) LOCAL MACRO LIST ( 
%*DEFINE (MACRO) LOCAL %LOCALS (%BODY) 
%*DEFINE (LIST) (%TEXT) 
%IF(%LEN(%*LIST) EQ0)THEN ( 
%DEFINE (%PARM) (%0) 
%MACRO) 
ELSE( 

%WHILE (%LEN(%*LIST) NE 0) ( 

%DEFINE(%PARM)(%*SUBSTR(%*LIST,1,1)) 
%DEFINE (LIST) (%*SUBSTR(%*LIST,2,9999)) 
%MACRO)) 
Fl) 

The statement DB n DUP(?) in the STACK segment only appears when the 8080 
source file contains a STKLN directive. In that case, n corresponds to the operand 
of the 8080 STKLN directive. 

These statements help to set up a pseudo-8080 environment, since an 8086 segment 
cannot exceed 64K bytes. The register mappings help to complete the pseudo-8080 
environment. 



NOTE 

If more than one module is linked, multiple ABS segments will cause 

LINK86 to issue error messages concerning SEGMENT OVERLAP . These 
errors are nonfatal and can be ignored, but you should check your 8080 

ASEG (now the 8086 ABS segment) to make sure that you intend the 

overlap to occur. See Appendix G for further details. 



What If a Converted Program Exceeds 64K? 

If your 8080 object file exceeds 50K bytes, then there is a chance that your converted 
source file, when assembled, will exceed 64K bytes and therefore will be too large to 
fit into a single 8086 segment. (To determine this, you must first convert your 8080 
source file, including required manual editing of 8086 source code, and then assem- 
ble under the MCS-86 Assembler. An error message will inform you if the resulting 
MCS-86 object file exceeds 64K bytes.) 
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If your converted program exceeds 64K bytes, you must reorganize your MCS-86 
source code into two or more segments, or else optimize your converted program (by 
recoding portions directly in more efficient MCS-86 source code). 

To reorganize your converted program into two or more segments, you will need to 
change the GROUP, SEGMENT, and ASSUME assembler directives as described in 
the manual, MCS-86 Macro Assembly Language Reference Manual, Order No. 
9800640. 

If you need to reorganize your converted program, you can place your data in one 
segment or group based at absolute location 0, and place your code in another seg- 
ment or group located above the data segment (or group). You should pay particular 
attention to absolute addresses and pointers (address values stored as data) in this 
case, to ensure that your program accesses its data as originally intended. 



How Does CONV86 Handle the Stack? 

If present, "STKLN" is converted to "DB n DUP(?)" in the STACK segment, 
where n is taken from the operand of STKLN. The reserved name STACK is con- 
verted to STACK_BASE. (See also "Initializing Registers" under "8086 
Checklist" in Chapter 3.) 



How Are the 8080/8085 Registers Mapped into 8086 Registers? 



Byte registers are mapped as follows: 



8080/8085 


8086 


A 


AL 


B 


CH 


C 


CL 


D 


DH 


E 


DL 


H 


BH 


L 


BL 



Word registers are mapped as follows: 



8080/8085 


8086 


PSW 


AX 


B 


CX 


D 


DX 


H 


BX 


SP 


SP 
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How Are the 8080 Flags Mapped into the 8086 Flags? 

The 8080 flags correspond to a subset 1 of the 8086 flags as shown in Table 1-1 : 



Table 1-1 . 8080-8086 Flag Correspondence 



Flag Name 


8080 
Designation 


8086 
Designation 


Auxiliary-carry 

Carry 

Zero 

Sign 

Parity 


AC 
C 

Z 

s 

p 


AF 
CF 
ZF 
SF 
PF 



1. Four 8086 flags do not concern us here: DF (direction), IF (interrupt-enable), OF (overflow), 
and TF (trap). 



How Are 8080/8085 Instructions Mapped into 8086 Instructions? 

Appendix A shows how all instructions are mapped. But first, consider that it is not 
enough simply to map an 8080 instruction mnemonic directly into an 8086 instruc- 
tion mnemonic, because the instruction operands must be examined as well. 



How Are 8080 Operands (Expressions) Converted to 8086 Operands (Expressions)? 

8086 Assembly Language is a typed language, whereas 8080/8085 is not. Thus, 
CONV86 must assign a type— BYTE, WORD, or NEAR— to each symbol en- 
countered in your 8080/8085 source file. Each symbol is typed according to its most 
frequent usage. After each symbol has been assigned a type (at the end of the first 
pass of CONV86), CONV86 can explicitly override the type in 8086 source code 
when necessary. 

Appendix B describes the conversion of 8080 expressions into 8086 expressions as a 
function of the context and the operand or expression type. For example, during its 
first pass in converting your 8080 source file, CONV86 may find the symbol 
LASZLO used in three different contexts: 



8080 

LDA 



LASZLO ;Load accumulator with byte at LASZLO. 



LHLD 



LASZLO ;Load (H,L) with word at LASZLO. 



JMP 



LASZLO ; Jump to symbolic location LASZLO. 
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Since all three usages of the same symbol are permitted in 8080/8085 assembly 
language, but since 8086 assembly language permits a symbol to be of only one 
type— BYTE, WORD, or NEAR— then CONV86 must assign a single type to 
LASZLO. In this case, LASZLO is assigned type BYTE, and the remaining two 
occurrences of LASZLO are overridden as follows: 

8086 

MOV AL, LASZLO ;Load AL with byte at LASZLO. 

MOV BX, WORD PTR(LASZLO) ; Load BX with word at LASZLO. 

JMP NEAR PTR(LASZLO) ;Jump to symbolic location LASZLO. 



How Are Comments Mapped? 

Comments are mapped unchanged. However, metacharacters (%) or unmatched 
parentheses in 8080 source comments may be misinterpreted by ASM86. 



How Are 8080/8085 Assembler Directives Mapped Into 8086 Assembler 
Directives? 

Appendix C shows the assembler directive mapping. 

Operands (expressions) of all directives are mapped according to Appendix B. 

How Are 8080/8085 Assembler Controls Mapped? 

CONV86 deletes the MOD85, NOMACROFILE, COND, NOCOND, 
MACRODEBUG and NOMACRODEBUG controls, and issues corresponding cau- 
tion messages. 

The MACROFILE (:Fn:) control, specified with its argument, will be converted to 
WORKFILES (:Fn:,:Fn:). The MACROFILE control will not be converted cor- 
rectly if you have not specified it with its optional argument. Such a control can be 
deleted from the 8080/8085 source file or from the converter output file. All other 
8080/8085 assembler controls are copied unchanged to the 8086 output file. 

The only 8080/8085 assembler control interpreted by the converter is the INCLUDE 
control, which causes included files to be processed in the first pass. Included files 
are neither listed nor converted when the main source file is converted; they are pro- 
cessed in order to evaluate symbol definitions and attributes. The maximum nesting 
level for included files is four. 

How Does CONV86 Handle 8086 Reserved Names? 

Whenever CONV86 encounters an 8086 reserved name (such as AL, TEST, or 
LOOP) in an 8080/8085 source file, CONV86 appends an underscore to the name 

(thus obtaining AL , TEST , or LOOP_). The only exception to this rule is 

STACK, which is converted to STACK__BASE. As a result, you don't need to be 
concerned about any 8086 reserved names that might be hiding in your 8080/8085 
source files. Appendix D gives a complete list of 8086 reserved names. 
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Functional Equivalence 

What Is Functional Equivalence? 

The ideal conversion results in total functional equivalence, which means that the 
converted 8086 source file, when assembled, linked, located, and run, performs the 
equivalent function of the input 8080/8085 source file. 

CONV86 cannot infer the intent of your source program. 

While CONV86 cannot usually achieve total 1 functional equivalence on a per- pro- 
gram basis, CONV86 can, in almost every instance, achieve functional equivalence 
on a line-by-line basis. This means that CONV86 attempts to "map" each 
8080/8085 instruction, directive, or control into its 8086 counterpart, if it exists. 

Using the instruction mapping of Appendix A, the operand (expression) mapping of 
Appendix B, and the directive mapping of Appendix C, CONV86 achieves line-by- 
line functional equivalence. Problems encountered in achieving program functional 
equivalence arise from: 

• Symbol-typing ambiguities — overridden symbol types might not yield the 
desired 8086 source code. CONV86 flags potential problems of this sort with 
caution messages. 

• Machine-dependent sequences, such as software timing delays or other 
sequences which depend on instruction length or clock periods. 



What About Program Execution Time? 

The 8086 assembly-language instructions produced by CONV86 require, in general, 
more clock periods than did the original 8080/8085 instructions. Thus, the 8086 
code produced is less efficient in terms of instruction cycles. However, since the 8086 
can be driven by a faster clock, this loss of instruction-cycle efficiency is offset. 



What Happens to Software Timing Delays in Conversion? 

You should examine the 8086 code derived from timing delay loops. Then, taking in- 
to consideration the number of cycles for each 8086 instruction involved, as well as 
the bandwidth (frequency) of your 8086 clock, you can manually edit the 8086 
source code to preserve your timing delays. You should also take into account the 
8086 instruction queue (pipeline), which contains six prefetched bytes of in-line 
code. 



Does the 8086 Code Produced Set Flags Exactly as on the 8080? 

Yes, unless you specify the APPROX control when you run CONV86. Table 1-2 
shows the five 8080 instructions whose 8086 counterparts set flags differently if AP- 
PROX is specified. The EXACT control (a default) forces all flag settings to be 
preserved. 



'Total functional equivalence on a per-program basis would constrain instruction sequence sizes and 
clocks to be preserved. 
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Table 1-2. Flag Settings That Change If APPROX Is Specified 



Source 




Equivalent 




8080 


8080 Flags Affected 


8086 


8086 Flags Affected 


Instruction 




Instruction 




DAD 


CY 


ADDBX,_ 


AF,CF,PF,SF,ZF 


INX 


none 


INC 


AF,PF,SF,ZF 


DCX 


none 


DEC 


AF,PF,SF,ZF 


PUSH PSW 


none; saved in stack 


PUSH AX 


none 


POP PSW 


Z,S,P,CY,AC 


POP AX 


[SEE NOTE 1] 



[NOTE 1: No flags are set if APPROX is specified. EXACT sets AF, CF, PF, SF, and ZF (but not 
OF).] 



How Does the EXACT Control Preserve Flag Semantics? 

By inserting the LAHF (load AH with flags) and SAHF (store flags from AH) in- 
structions before and after the 8086 counterpart of the 8080 instruction being con- 
verted. For example, the 8080 instruction INX B increments the 16-bit register-pair 
(B,C) without affecting any 8080/8085 flags, whereas the 8086 instruction INC CX 
not only increments the 16-bit register CX on the 8086, but also can affect four rele- 
vant flags: 

• Auxiliary-carry flag (AF) 

• Parity flag (PF) 

• Sign flag (SF) 

• Zero flag (ZF) 

If your program is not concerned with these flag settings, then the APPROX mapp- 
ing will suffice: 



8080 8086 

INX B (APPROX)-^ INC CX 



However, if your program flow depends on the settings of any of the four flags men- 
tioned, you will want to ensure that in your 8086 program, these flags are saved 
before INC CX is executed, and restored after INC CX is executed. The EXACT 
control does this for you as follows: 



8080 
INXB- 



(EXACT)- 



8086 
LAHF 
INCCX 
SAHF 



COMMENTS 
;Load flags into AH. 

;Store flags from AH. 



Similar flag-preserving code results from EXACT conversion of the 8080/8085 
instructions DCX, DAD, PUSH PSW and POP PSW. 

When in doubt, let CONV86 default to the EXACT control. More 8086 source code 
is generated than for APPROX, but the code can be counted on to preserve the flag- 
setting semantics of your 8080/8085 program. 
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What Output Files Does CONV86 Create? 

Table 1-3 shows CONV86 output files, their default extensions, and uses. 

Table 1-3. CON V86 Output Files 



File Designation in 
Invoking Command 


Default File-Name 


Contents and Use 


OUTPUT 
PRINT 


:Fs:source.A86 
:Fs:source.LST 


Machine-readable 8086 source file; to be 
manually edited according to caution 
messages in PRINT file. 

1) Optional copy of 8080/8085 source. 

2) Human-readable 8086 source file with 
embedded caution messages for 
manually editing OUTPUT file. 



What Are Caution Messages? 

In general, CONV86 issues a caution message when it detects a potential problem in 
the converted 8086 source code. Caution messages can alert you to possible symbol 
type ambiguities, such as a symbol used both as a byte and a word, or to possible dis- 
placed references, such as JMP $ + (exp). In the latter case, the displacement (exp) 
usually increases in going from the 8080 to the 8086. Chapter 3 describes caution 
messages and identifies what, if anything, you need to do to your 8086 source file. 

Does a Caution Message Necessarily Mean a Manual Edit? 

No. In some instances, such as displaced references, CONV86 cannot be sure if an 
error exists. In other instances, such as MOD85 CONTROL DELETED, the con- 
verter is simply informing you of a deliberately omitted source file control. Never- 
theless, all caution messages and the lines to which they apply demand scrutiny. 

Do Caution Messages Identify All Manual Editing? 

No. Since CONV86 cannot infer the intent of a source program, you must be the 
final judge as to whether the 8086 source code produced will do a satisfactory job. In 
particular, you should be alert to machine-dependent sequences of instructions, 
bearing in mind that instruction sizes (lengths) and execution time (clocks) will 
change in going from the 8080/8085 to the 8086. 

Also, certain 8080/8085 Assembly Language constructs, not valid in the MCS-86 
Macro Assembly Language, are not detected by CONV86. These constructs are 
flagged as errors by ASM86. For example, a nested macro definition that uses the 
same macro name (a valid construct in the 8080/8085 Assembly Language) is invalid 
in the MCS-86 Macro Assembly Language. This construct is not detected by 
CONV86 but it is flagged as an error by ASM86, alerting you about the problem. 

The 8080/8085 assembler control MACROFILE is not converted correctly if its 
optional argument is not present. CONV86 does not issue a caution for this condi- 
tion and ASM86 processing of the converter output file is terminated by a fatal 
error, "BAD WORKFILE COMMAND." This problem can be corrected by editing 
the converter output file or removing the MACROFILE control from the 8080/8085 
source file before it is converted. 



1-13 




CHAPTER 2 
OPERATING THE CONVERTER 



Source File Requirements 

Before operating the converter program CONV86, you should ensure that the main 
source file and all included source files meet the following requirements: 

1 . The source file must be capable of being assembled without errors by the ISIS-II 
8080/8085 Assembler. 

2. Diskettes containing files INCLUDEd by the main source file must be mounted 
on their indicated diskette drives. 

3. The maximum source line length is 129 characters, not including carriage- 
return and line-feed characters. Longer lines are converted to comments and 
flagged with a caution message. 

4. The maximum number of symbols allowed per conversion is approximately 600. 
Programs having more than 600 symbols must be divided into smaller 
programs. 

CONV86 Controls and Defaults 

If the above requirements are met, you can invoke the converter under ISIS-II by 
entering the command: 

:Fn:CONV86 source controls 

where source is the name of the file to be converted, and controls are as described in 
Table 2-1. 

Table 2-1 . CONV86 Controls and Defaults 



CONTROLS 


DEFAULTS 


PRINT(path-name) / NOPRINT 


PRINT(:Fs:source.LST) 


OUTPUT(path-name) / NOOUTPUT 


OUTPUT(:Fs:source.A86) 


DATE('date') 


DATEC ') 


TITLE('title') 


TITLEC ') 


PAGELENGTH(n) / NOPAGING 


PAGELENGTH(60) 


PAGEWIDTH(n) 


PAGEWIDTH(120) 


EXACT / APPROX 


EXACT 


INCLUDED / NOTINCLUDED 


NOTINCLUDED 


ABS/REL 


REL 


WORKFILES(:Fn:) 


WORKFILES(:Fs.) 


SOURCELIST/NOSOURCELIST 


SOURCELIST 
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where: 



Fs 

specifies the diskette unit on which the source file resides. 

PRINT 

specifies an ISIS-II path-name (file or device designation) for a copy of 
your 8080/8085 source code together with generated 8086 source code 
and embedded caution messages. 

NOPRINT 

specifies that the PRINT file is not to be created. 

OUTPUT 

specifies an ISIS-II path-name for the output 8086 source code. Refer to 
Table 1-3, "CONV86 Output Files." 

NOOUTPUT 

specifies that the OUTPUT file is not to be created. 

DATE 

specifies a date (or other information) of up to nine characters to be 
printed in the page header of the PRINT file. 



TITLE 



specifies a title (or other information) of up to 40 characters to be printed 
in the page header of the PRINT file. 

PAGELENGTH(n) 

specifies the number of lines per output page in the PRINT file. The 
minimum is four lines per page; there is no effective maximum. 

NOPAGING 

specifies no forms control and is equivalent to PAGELENGTH (65535). 

PAGEWIDTH(n) 

specifies the number of characters per output line in the PRINT file. The 
minimum is 60 characters per line; there is no effective maximum. 



EXACT 



specifies that full flag-setting semantics are to be preserved in conver- 
sion. This control affects conversion of the DAD, DCX, INX, POP 
PSW, and PUSH PSW. 



APPROX 



specifies that full flag-setting semantics are not to be preserved for the 
instructions DAD, DCX, INX, POP PSW, and PUSH PSW. Refer to 
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Chapter 1, "Functional Equivalence," for a description of flag 
preservation. 

INCLUDED 

specifies that this module is included in another module for assembly. 
This control suppresses generation of a standard prologue. 

NOTINCLUDED 

specifies that this module is not included in another module for 
assembly. The converter therefore generates a standard prologue. Refer 
to Chapter 1, "Functional Mapping," for a description of prologues. 



REL 



specifies that this module will subsequently be assembled in relocatable 
format and/or linked to a PL/M-86 module. If REL and 
NOTINCLUDED are both specified or defaulted to (both are defaults), 
the standard prologue generated is compatible with PL/M-86, and 
informs the converter that 8080 relocation capabilities are present in the 
source file and must be mapped into 8086 relocation features. See 
"Functional Mapping" in Chapter 1 . 



ABS 



specifies that this module is absolute and not relocatable (and hence not 
to be linked to a PL/M-86 module). If ABS and NOTINCLUDED are 
both in effect (NOTINCLUDED is a default), then the standard pro- 
logue generated is not compatible with PL/M-86, but is compatible with 
other 8086 assemblies. See "Functional Mapping" in Chapter 1 for a 
description of standard prologues. 

WORKFILES(:Fn:) 

specifies that the single, temporary workfile CONV86.TMP is to be 
created on (and subsequently deleted from) diskette unit :Fn:, where n 
defaults to the source file diskette unit number if the WORKFILES con- 
trol is omitted. The single workfile created (the plural WORKFILES is 
used for consistency with other programs) requires seven (7) bytes for 
each source line. 

SOURCELIST 

specifies that the 8080/8085 source program is to be listed in the PRINT 
file (overridden by NOPRINT). 

NOSOURCELIST 

specifies that the 8080/8085 source program is not to be listed in the 
PRINT file. 



Examples 

Example 1 . Full Default Saves Flags and Relocatability 

Suppose CONV86 resides on diskette unit 0, and that the program to be converted is 
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named MYASM.A80 and resides on diskette unit 1 . Then the command: 

CONV86 :F1:MYASM.A80 

invokes the converter and results in the following controls: 

The 8080 source file and 8086 source file with embedded cautions are written to 
the file :F1:MYASM.LST 

The converted file (without embedded caution messages) is placed in the file 
:F1:MYASM.A86 

Blanks appear in the title and date fields of page headers. 

Page lengths default to 60 lines per page. 

Page widths (line lengths) default to 120 characters, not including 
carriage-return or line-feed. 

Flag-setting semantics are preserved for all instructions. 

The prologue generated in the OUTPUT file :F1:MYASM.A86 will cause the 
MCS-86 Assembler to generate relocatable object modules suitable for linking 
with other assemblies or PL/M-86 object modules. 

The temporary workfile CONV86.TMP is created on, and deleted from, 
diskette unit 1, the default. 



Example 2: Absolute Code with No Flags Saved 
If, in Example 1, you had entered the command: 

CONV86 :F1:MYASM.A80 ABS APPROX 

then the results would differ as follows: 

• Full flag-setting semantics are not preserved for DAD, DCX, INX, PUSH 
PSW, or POP PSW. 

• A standard 8086 assembly language absolute prologue is generated in the 
converted code. This prologue is not compatible with PL/M-86, but is com- 
patible with other 8086 assemblies. Your MCS-86 Assembler object file will not 
be relocatable. 

Example 3: Absolute Code with Flags Saved 

The invoking command: 

CONV86:F1:MYASM.A80 ABS 

generates an absolute prologue, and defaults to EXACT. 

Example 4: Relocatable Code with No Flags Saved 

The invoking command: 

CONV86:F1:MYASM.A80 APPROX 

does not preserve flag semantics for the five instructions just mentioned, and 
defaults to REL. 

NOTE 

In the following examples, the double asterisks (**) indicating prompting 
are generated internally, and not by the user. 
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Example 5: Prompting and Continuation Lines 

You need not enter the entire invoking command on a single line. If you wish to con- 
tinue the command on one or more subsequent lines, you must enter an ampersand 
(&) as the last character of the current line. Characters entered following the amper- 
sand and preceding the carriage-return are comments; they are echoed by CONV86 
in the PRINT file header but are not processed. The converter then prompts for 
more command input with a double asterisk: 

CONV86 :F1 :MYASM.A80 & source file is MYASM.A80 on disk drive 1 

** DATE('10/5/78')& date cannot exceed 9 chars, excluding quotes 

** TITLECCONVERSION TEST 39, PROJECT AXOLOTL') & 40 chars. 

The date and title are included in the PRINT file headers as shown in Figure 1-3, 
Chapter 1 . The remaining controls default as in Example 1 . 

Example 6: Overriding Controls 

It may happen that you have entered a control incorrectly, or for some other reason 
wish to override a previously entered control. You can override any previously 
entered controls so long as prompting is in effect. Suppose you have entered the 
following: 

CONV86 :F1:MYASM.80& 

**DATE('10/5/39')& 

** TITLECCONVERSION TEST 78, PROJECT AXOLOTL') & 

If you happen to notice at this point that the wrong information has been entered — 
that is, the 39 and 78 have been interchanged, there is no problem, since prompting 
is still in effect. On subsequent continuation lines, you can enter: 

**DATE('10/5/78')& 

"TITLECCONVERSION TEST 39, PROJECT AXOLOTL') & 



Controls can be entered in any order and overridden in any order as many times as 
necessary. For this reason, it is good practice to end every line with an unquoted 
ampersand. When you are satisfied that the controls are correct, you can end the 
command with the last line consisting of a lone carriage return. 



Console Output 



When you have entered the command invoking CONV86, the converter responds 
with the message: 

ISIS-II ASM80 TO ASM86 CONVERTER Vx.y 
where x.y is the version designation. 
Normal termination of the converter causes it to issue the message: 

ASM80 TO ASM86 CONVERSION COMPLETE 

nnnnn CAUTIONS ISSUED 
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where nnnnn is the number of messages generated for the run. Caution messages are 
described in Chapter 3. 



CONV86 terminates abnormaly (aborts) if I/O or other fatal errors occur during 
execution, or if CONV86 has not been properly invoked. 



Fatal I/O console messages are of the form: 
ASM80-TO-86 I/O ERROR- 
FILE: file-type 
NAME: file-name 
ERROR: error-message 
CONVERSION TERMINATED 

Table 2-2 shows the relationship between file-type and file-name. 

Table 2-2. File-types and File-names in CONV86 Fatal I/O Errors 



FILE-TYPE 


FILE-NAME 


LIST 

OUTPUT 

SOURCE 

INCLUD 

TEMP 

:CI: 


Specified by PRINT control 
Specified by OUTPUT control (or default) 
Specified by source field of command 
Specified by ASM80 INCLUDE control 
CONV86.TMP— temporary work file 
Refers to console input device 



Error-message is one of the following: 

04 —ILLEGAL FILENAME SPECIFICATION 

05 — ILLEGAL OR UNRECOGNIZED DEVICE SPECIFICATION IN FILENAME 

12 — ATTEMPT TO OPEN AN ALREADY OPEN FILE 

13 -NO SUCH FILE 

14 -FILE IS WRITE PROTECTED 

19 — FILE IS NOT ON A DIRECT ACCESS DEVICE 

22 — DEVICE NAME NOT COMPATIBLE WITH INTENDED FILE USE 

23 - FILENAME REQUIRED ON DIRECT ACCESS FILE 
28 —NULL FILE EXTENSION 

254 — ATTEMPT TO READ PAST EOF 



Fatal errors (other than I/O) result in the following console display: 
ASM80-TO-86 FATAL ERROR— 
message 
CONVERSION TERMINATED 
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Messages corresponding to (non-I/O) fatal errors are as follows: 

MESSAGE ACTION 



CONDITIONALLY ASSEMBLED MACRO 
CONDITIONALLY ASSEMBLED ENDM 
INVALID FILENAME 
INVALID CONTROL FORMAT 
CONTROL STRING TOO LONG 
INVALID CONTROL VALUE 
INVOCATION COMMAND DOES NOT 

END WITH <CRXLF> 
UNKNOWN CONTROL 
INSUFFICIENT MEMORY FOR DICTIONARY 

MAXIMUM MACRO NESTING LEVEL 
EXCEEDED 



Remove conditional directives 
Remove conditional directives 
Examine, correct file name 
Refer to beginning of Chapter 2 
Reduce length(s) of DATA/TITLE strings 
Refer to Controls description 
Reenter with carriage return 

Refer to Controls description 

Reduce the number of symbols used in your 

program 

Check for recursive macro calls; reduce the 

number of nested macro calls 
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Interpreting the PRINT File 



After you have run CONV86 and it has terminated normally, you should examine 
the PRINT file. As shown in Figure 3-1, the PRINT file consists of: 

• A copy of the 8080/8085 assembly-language source file, unless the 
NOSOURCELIST control was specified 

• MCS-86 assembly-language source code with embedded caution messages 

Using the PRINT file as a reference, you can manually edit the OUTPUT file to 
obtain 8086 source code that can be assembled by the MCS-86 Macro Assembler. 




Figure 3-1. Annotated PRINT File 
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8086 Checklist 

Caution messages and the modifications they may require are described later in this 
chapter. This section provides a list of items that you should check yourself. 

1. Initializing Registers. Before your converted program can be assembled for 
subsequent linking, locating, and execution, you must insert register initializa- 
tion code at the entry point to your main program. The register initialization 
code that you insert must be the first sequence of instructions executed by your 
program. If you omit this code from your main program, neither the segment 
registers nor the stack pointer (SP) can be depended on to contain meaningful 
data, and the results are unpredictable. 

The code that you insert follows. Note that expr should not be coded verbatim; 
what you substitute for expr depends on whether you converted using the ABS 
or REL control (REL is the default), and how your 8080/8085 program 
initialized SP. 



mainen trypoin t: 



CLI 

MOV AX,CS 
MOV DS,AX 
MOV ES.AX 
MOVSS.AX 
LEA SP, expr 
STI 



First instruction to be executed in your main 

program 

UseCS to initialize: 

—data segment register 

—extra segment register 

—stack segment register 

See below for what to code for expr 

Enable interrupts 



where: 



mainen trypoin t 



expr 



is the symbolic location of the first instruction to be executed 
in your main program. If, in your original 8080 program 
development, you used the 8080 LOCATE control 
RESTART0 (to have the locater insert code to jump to the 
entry point of your main module when the 8080 was reset), 
the corresponding LOC86 control is BOOTSTRAP . 

is STACK BASE if you converted using the REL control 

and your original 8080 program used the STKLN directive to 
set the stack size. 

Otherwise expr is a constant, expression, or program label 
that your original 8080 program used to set SP. For constants 
or expressions, you should check that these values are really 
what you want. 



You should check every instance in your program where SP is loaded to ensure 
that the stack reinitialization has the intended effect in your converted program. 



2. Absolute Addressing. Absolute addresses should be checked for correctness. 
This includes ORGs in the absolute segment, LHLD and LDA from a constant 
location, and immediate operations such as LXI whose constant operands 
represent addresses. Remember that 8086 instruction lengths are generally dif- 
ferent from those of their 8080/8085 counterparts. 

3. Relative Addressing. Relative addressing should be checked, since the number 
of bytes between instructions will in general increase in going from 8080/8085 to 
8086. In some instances, CONV86 generates and inserts a label of the form 
L n for a displaced reference, as in the following: 
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8080 Source 



MCS-86 (CONV86-Generated) PRINT File 



2 




MOV D,B 


2 




MOV 


Dh,Ch 


3 




JMP $+4 


3 




JMP 


SHORT L_1 


4 


LO: 


MOV C,B 


4 


LO: 


MOV 


CL,Ch 


5 




MOV A,L 


5 


L_1 : 


MOV 


AL,BL 



In some instances, however, CONV86 does not generate such a label, as in the 
following: 



8080 Source 



MCS-86 (CONV86-Generated) PRINT File 



7 


MOV A , C 


7 


MOV 


AL,CL 


I 


JMP $ + 3*( (3+2)*2-7) 


6 


JMP 


$+3*((3+2)*2-7) 


9 


DB 7fch 


CAUTION 


017 *** 


ADDRESS EXPRESSION 


10 


DB 101 1 1 101B 


9 


DB 


Ibh. 


11 


Dto OBAbAh 


10 


DB 


101 11 101B 


12 


DW OBEACH 


1 1 


DW 


OBABAh 


13 


CMA 


12 


DW 


OBEACh 






13 


NOT 


AL 



CONV86 does not attempt to evaluate the expression or insert a label, although 
Caution Message 17 is issued for a possible displaced reference. Thus, it is up to 
you to insert a label. At the same time, since the jump (forward) is less than 127 
bytes, the SHORT label attribute can be used, as follows: 



CONV86 OUTPUT File 



MOV 


AL,CL 




MOV 


AL,CL 


JMP 


$+3*((3+2)*2- 


-7) 


JMP 


SHORT LASZLO 


Db 


7&h 




DB 


78h 


DB 


101 1 1 101B 




Db 


10111 101B 


DW 


OBABAh 




DW 


OBAbAh 


DW 


OBEACh 




DW 


OBEACH 


NOT 


AL 




LASZL0: NOT 


AL 



Before Your Edit 



After Your Edit 



In general, you should check all relative addressing. 



Interrupts. Figure 3-2 shows how interrupt service routines on the 8080/8085 
can be converted to interrupt service routines on the 8086. 

The principal difference between the two schemes is that on the 8080/8085, con- 
trol traps to location 8*N, where executable code resides; whereas on the 8086, 
control traps to the location pointed to by the 16-bit offset and 16-bit base 
values stored at location 4*N. 
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CONV86 



8080/8085 



8086 



:!PUSH> 
ftPUSHS 
:PUSHS 
:;PUSHS 

;push¥ 

:!PUSH:: 
!:PUSH:: 
: PUSH: 
i: CALL J 
iPOP:::! 

;pop;:S: 

:.POP:S: 
iPOPW: 
SPOP:W: 
JPOP:ffi 
SPOPSS 
::POP;:B 
SlRETSS 






USER-INITIALIZED 
OFFSET & BASE 
VALUES POINT 
TO CALLING 
SEQUENCE 



S.ES SSS 
OS 

; ax 

:CX 

DX",- 
: BX 
SI 

KDI ?»« 
JINTERj 
SDI i?::;;; 
.SI ..::•••=:'•': 
BX 

DX • 
CX •••: : 
::AX':S;:S; 
JDSSSS 



INTER PROC NEAR 



MOMWmmm 
xor • •••"••".. 
push»ss;*®§¥ 
callintprc: 

RET • •-,• 



INTER ENDP 



INTPRC! 



(CONVERTED USER-WRITTEN 
INTERRUPT SERVICE ROUTINE)! 



^CONVERTED* 
APPLICATIONS 

SSPROGRAMSS 



|P:inNXNl : il|l 



USER-INSERTED 
CALLING SEQUENCE 
INVOKES CONVERTED 
USER-WRITTEN 
INTERRUPT VECTOR 
INSTRUCTION 
SEQUENCE 



CONVERTED INTERRUPT 
VECTOR INSTRUCTION 
SEQUENCE REQUIRES 
USER-INSERTED 
PROCEDURE 
DEFINITION 



Figure 3-2. Converting Your Interrupt Procedures 
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You can convert your 8080 interrupt service routines as follows: 

1 . Insert, at a convenient place in your 8086 source code, the following calling 
sequence, using your own label (be sure not to use a reserved name given in 
Appendix D): 

INTSEQ: 



PUSH 


ES 




PUSH 


DS 




PUSH 


AX 




PUSH 


CX 




PUSH 


DX 




PUSH 


BX 




PUSH 


SI 




PUSH 


Dl 




CALL 


INTER 


;INTER used here for example in Figure 3-2 


POP 


Dl 




POP 


SI 




POP 


BX 




POP 


DX 




POP 


CX 




POP 


AX 




POP 


DS 




POP 


ES 




IRET 




;Note that this is IRET, and not RET. 



2. Insert the following initialization sequence for absolute location 4*N in the 
ABS segment: 



ORG4*N 

DD CGROUP:INTSEQ 
DD INTSEQ 



;N is the interrupt number on the 8086. 
;INTSEQ used here for example above. 



;lf REL control was used. 
;lf ABS control was used. 



3. Sandwich the converted code from INTER (used here for example in Figure 
3-2) between PROC and ENDP statements as follows: 

INTER PROC NEAR ;Nothing special about the word INTER. 

[converted code] 



INTER ENDP 



;Nothing special about the word INTER. 



While these steps are general enough to cover virtually any application, you 
may find that as you become familiar with the 8086, you can recode your 
interrupt service routines in MCS-86 Macro Assembly Language to obtain 
optimal code more suited to your application. 
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PL/M-86 Linkage Conventions 



The only PL/M-86 model of computation relevant to conversion is the SMALL 
model. 



Case 1: When PL/M Calls 

Converted assembly-language programs called from PL/M programs must be 
changed if any parameters are passed, since PL/M-80 passes parameters in registers 
and on the stack, and PL/M-86 passes all parameters on the stack. PL/M-86 
parameter passing is as follows: 

• Arguments are pushed on the stack in left-to-right order and therefore 
occupy successively lower memory locations. The return address is pushed 
on the stack last. 

• Each argument occupies two bytes. One-byte arguments are passed in the 
lower half (least significant byte) of a word. 

Therefore, converted 8086 assembly language programs called from PL/M-86 pro- 
grams need to access arguments from the stack, and not from registers. However, 
since the calling PL/M-86 program has pushed the return address on the stack last, 
the called 8086 assembly language program needs to: 

1 . POP the return address to any convenient word register, such as BX. 

2. POP arguments as needed into their 8086 register counterparts, as follows: 

• If no arguments are expected, POP no further. Go to Step 3 below. 

• If one argument is expected, then it was originally expected in (B,C). 
Therefore the converted assembly language program is accessing the single 
argument from the 8086 CX register. This means that you need to insert the 
instruction: 

POP CX ;Retrieve only PL/M-86 argument. 

immediately after POP BX (the return address) in order for the converted 
8086 assembly language program to access the single argument as intended. 

• If two arguments are expected, then they were originally expected in (B,C) 
and (D,E). Therefore the converted assembly language program accesses its 
arguments from the 8086 CX and DX registers. Since PL/M-86 passes these 
arguments on the stack in order, this means that you need to insert the 
instructions: 

POP DX ; Retrieve second PL/M-86 argument. 
POPCX ;Retrieve first PL/M-86 argument. 

immediately after POP BX (the return address) in order for the converted 
8086 assembly language program to access the two arguments as intended. 

• If more than two arguments are expected, the remainder are in the stack 
(where the converted assembly language program expects them), and there 
is no problem. The last two arguments are accessed as described in the 
preceding paragraph. 

3. PUSH the return address back on the stack immediately after accessing the 
arguments as just described. If BX was used in Step 1 above to retain the return 
address, then you need to insert the instruction: 

PUSH BX ;Replace return address on stack. 

immediately following your argument-accessing sequence of POPs. 

4. PL/M-86 expects the return value (a one-word pointer or data item) of the 
assembly language program to be in the AX register. If the return value is a 
byte, it is expected in AL. 
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Case 2: When Your Converted Program Calls 

If your 8080/8085 source program calls another routine (written either in MCS-86 
Macro Assembly Language or PL/M-86) which expects arguments to be passed on 
the stack, you need to insert 8086 source code in your converted program. 

If your original 8080 source program passed only one argument to the CALLed 
routine, that argument was passed in the (B,C) register-pair. Hence you need to 
insert: 

PUSH CX ;Push (B,C) argument on stack. 

immediately before the CALL. 

If your original 8080 source program passed two or more arguments to the CALLed 
routine, those arguments were passed in the (B,C) register-pair, in the (D,E) register- 
pair, and remaining arguments on the stack. Hence you need to insert: 

PUSHCX ;Push(B,C) argument on stack. 
PUSH DX ;Push (D,E) argument on stack. 

immediately before the CALL. The remaining arguments (if any) are already on the 
stack in the correct order. PL/M-86 return values are placed in AX or AL as 
described in Case 1 . 



Caution Messages 

Caution messages do not necessarily imply manual editing, but they do demand 
scrutiny. In many cases, CONV86 cannot be sure if an error actually exists (as for 
instance, in expression evaluation). This section lists all possible caution messages. 
The next section lists caution message descriptions and indicates what manual 
editing of the output file may be necessary. 

The entire list of caution messages is as follows (note that caution messages 9, 15, 
26, and 29 do not exist): 

1 BYTE REGISTER USED IN WORD CONTEXT OR VICE VERSA 

2 8080 REGISTER MNEMONIC APPEARING IN IRPC STRING 

3 MACRO PARAMETER BOTH CONCATENATED AND USED AS PARAMETER 

4 EXPANDED NAME MAY BE RESERVED WHEN CONCATENATED 

5 MACRO PARAMETER USED IN BOTH BYTE AND WORD CONTEXTS 

6 EQU'D OR SET REGISTER SYMBOL USED IN BOTH BYTE AND WORD CONTEXTS 

7 MULTIPLY DEFINED EQU MAY NOT BE ASSIGNED PROPER TYPE 

8 UNKNOWN STATEMENT 

10 TYPE ASSIGNED TO INCLUDED SYMBOL MAY NOT AGREE WITH DEFINITION 

11 TRANSLATION OF NOP MAY NOT YIELD DESIRED RESULTS 

12 TRANSLATION OF RST MAY NOT YIELD DESIRED RESULTS 

13 8085-SPECIFIC INSTRUCTION CANNOT BE TRANSLATED 

14 FORWARD REFERENCE TO A SYMBOL WHICH IS A REGISTER OR [BX] CANNOT 
BE CORRECTLY ASSEMBLED 
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16 EXPRESSION ASSUMED TO BE A VARIABLE 

17 ADDRESS EXPRESSION MAY BE INVALID FOR 8086 

18 INSTRUCTION AS OPERAND CANNOT BE TRANSLATED 

19 REGISTER USED IN UNKNOWN CONTEXT 

20 OUTPUT LINE TOO LONG; TRUNCATED 

21 LABEL ASSUMED TO BE NEAR 

22 NOMACROFILE CONTROL DELETED 

23 MOD85 CONTROL DELETED 

24 SOURCE LINE TOO LONG; IGNORED 

25 CURRENT SEGMENT UNKNOWN; CANNOT GENERATE ENDS 

27 SYMBOL NAME TOO LONG 

28 CONDITIONAL ASSEMBLY GENERATED 

30 UNKNOWN INSTRUCTION ASSUMED TO BE A MACRO 

31 GENERATED LABEL MIGHT NEED TO BE DECLARED LOCAL 

32 (NO) COND CONTROL DELETED 

33 (NO) MACRODEBUG CONTROL DELETED 

34 METACHARACTER OR PARENTHESIS FOUND IN IRPC STRING 

35 EXPRESSION ASSUMED TO BE A CONSTANT 

36 SYMBOLIC EXPRESSION MAY BE CONTEXTUALLY INVALID FOR ASM86 
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Caution Message Descriptions 

1 BYTE REGISTER USED IN WORD CONTEXT OR VICE VERSA 

A register variable defined in an EQU directive or as a macro parameter has 
been classed as BYTE or WORD according to its predominant usage. In this 
statement, the register variable appears in the opposite context. This is 
unacceptable for the 8086, since byte and word register mnemonics are dif- 
ferent. You should insert the appropriate register mnemonic. 

2 8080 REGISTER MNEMONIC APPEARING IN IRPC STRING 

The parameter of this IRPC directive is used in a register context. Since 8086 
register mnemonics are two characters long, you should change the IRPC direc- 
tive (possibly to an equivalent IRP). 

3 MACRO PARAMETER BOTH CONCATENATED AND USED AS PARAMETER 

One of the arguments of this macro is both concatenated and used as a register. 
You may need to manually convert the mnemonics yourself. 

4 EXPANDED NAME MAY BE RESERVED WHEN CONCATENATED 

One of the arguments of this macro is concatenated. You should examine 
the resulting symbol and see if it corresponds to the intent of the 8080/8085 
source code. You should also check to see if the resulting concatenated name is 
reserved. A list of reserved symbols appears in Appendix D. 

5 MACRO PARAMETER USED IN BOTH BYTE AND WORD CONTEXTS 

A macro argument is used in both byte and word register contexts. Since the 
argument can be of only one type, you should manually alter the macro or over- 
ride the argument type. 

6 EQU'D OR SET REGISTER SYMBOL USED IN BOTH BYTE AND WORD CONTEXTS 

An EQU or SET symbol is used in both byte register and word register contexts. 
You should manually insert the appropriate register mnemonic(s). You may 
need to use two EQUs: one for byte usage, and one for word usage. 

7 MULTIPLY DEFINED EQU MAY NOT BE ASSIGNED PROPER TYPE 

An EQU symbol has been multiply defined, perhaps due to conditional com- 
pilation. You should eliminate the excess definition(s), and redefine as 
necessary. CONV86 may have assigned the wrong type. 

8 UNKNOWN STATEMENT 

The converter is unable to recognize this statement, possibly because its 
mnemonic is a macro parameter. You should either recode the 8080 source to 
produce recognizable statements (legal instructions) and submit the recoded 
8080 file to CONV86, or else simply insert the appropriate 8086 source code in 
the OUTPUT file. 
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10 TYPE ASSIGNED TO INCLUDED SYMBOL MAY NOT AGREE WITH DEFINITION 

The specified symbol is defined in an INCLUDE file. When the INCLUDE file 
is converted, the usage of the symbol may not be the same as inferred by 
CONV86 here. You should convert the INCLUDE file and examine the type 
CONV86 has assigned to it there, and then ensure that both usages are the same. 
If they are not, you should override the assigned usage in either file so as to 
make their types identical. 

11 TRANSLATION OF NOP MAY NOT YIELD DESIRED RESULTS 

An NOP instruction has been converted to XCHG AX, AX. This may not be the 
desired mapping, as it assembles into a one-byte instruction (3 clocks). 

12 TRANSLATION OF RST MAY NOT YIELD DESIRED RESULTS 

An RST instruction has been converted to an INT instruction for the 8086. You 
should verify that the original intent of the RST instruction was to cause an 
interrupt. You should examine the operand carefully to ensure that the instruc- 
tion traps to the desired absolute address, and that the intended routine to be 
trapped to will be bound to (loaded at) that address. 

13 8085-SPECIFIC INSTRUCTION CANNOT BE TRANSLATED 

The 8086 has no counterpart for RIM or SIM. You should recode according to 
the 8086 interrupt scheme as described in the 8086 Family User's Manual under 
"Interrupts." 

14 FORWARD REFERENCE TO A SYMBOL WHICH ISA REGISTER OR [BX] CANNOT BE 
CORRECTLY ASSEMBLED 

The 8086 assembler does not accept forward references to registers. You should 
move your register EQUs to the beginning of your file. 

16 EXPRESSION ASSUMED TO BE A VARIABLE 

CONV86 has not been able to determine what type of expression is in this 
instruction. CONV86 has assumed that the expression is a variable. If this 
assumption is incorrect, you should examine the resulting 8086 statement and 
recode the mapped expression to suit your intent. You may find it helpful to 
insert additional labels. 

17 ADDRESS EXPRESSION MAY BE INVALID FOR 8086 

Casel: Displaced Reference 

CONV86 may not have mapped a displaced symbol reference (for instance, 
$ + BAZ*(FOO-N)) correctly. You can manually check the mapped displace- 
ment. You may find it simpler (and safer) to insert additional labels or variables 
rather than manually calculating displacements. 

Case 2: HIGH/LOW Applied to Symbolic Address Expressions 

You should check the symbols operated on by the HIGH/LOW functions to 
ensure that their alignments in 8086 memory' correspond to their 8080 page 
alignments. 
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In addition, if you converted using the REL control (a default), you should 
insert a group override prefix as follows: 

Before Your Editing After Your Editing 

LOW(expr) LOWDGROUP-.(expr') 

HIGH(expr) HIGH DGROUP:(expr') 

Case 3: Overly Complex Expressions 

It is possible that an overly complex 8080 expression has resulted in unaccept- 
able MCS-86 source code in your OUTPUT file. You should examine the 
original 8080 expression carefully to determine its intent, and then hand- 
translate the expression to a valid MCS-86 expression that corresponds to the 
original intent. 

18 INSTRUCTION AS OPERAND CANNOT BE TRANSLATED 

8080/8085 instructions are not permitted as operands in your source file. 

19 REGISTER USED IN UNKNOWN CONTEXT 

A register was used in an unknown context, such as: 

REG EQU B 

If this directive appears in an INCLUDE file which does not reference REG, 
conversion of the INCLUDE file will result in a type ambiguity for B. That is, 
CONV86 will not know at the time of the INCLUDE file's conversion whether 
B maps into CH or CX. You should check to see whether you want B to map 
into a byte register or a word register, and change the converter's mapping 
accordingly. 

20 OUTPUT LINE TOO LONG; TRUNCATED 

An output line has exceeded 129 characters and has been truncated. You should 
recode the line in 8086 accordingly. 

21 LABEL ASSUMED TO BE NEAR 

CONV86 has been unable to determine how this label is used; it is assumed to be 
of type NEAR. Since CONV86 has no information on how to type this symbol, 
you should check its usage and change its type accordingly. 

22 NOMACROFILE CONTROL DELETED 

No corresponding control exists for the 8086 assembler. No manual editing is 
required for this caution. 

23 MOD85 CONTROL DELETED 

No corresponding control exists for the 8086 assembler. No manual editing is 
required for this caution. 

24 SOURCE LINE TOO LONG; IGNORED 

The current source line exceeds 129 characters and has been mapped into a com- 
ment in both 8080/8085 and 8086 output files. You can either recode the source 
line and reconvert the source file using CONV86, or you can insert 8086 code in 
the OUTPUT file to accomplish the intent of the source line. 
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25 CURRENTSEGMENT UNKNOWN; CANNOT GENERATE ENDS 

An END or SEG directive in 8086 implies a preceding ENDS directive to close 
the currently open segment. This segment is unknown. You should insert an 
ENDS directive of the appropriate type. 

27 SYMBOL NAME TOO LONG 

Symbol names in 8086 cannot exceed 31 characters. 

28 CONDITIONAL ASSEMBLY GENERATED 

CONV86 has assumed that it is possible that the operand of this PUSH or POP 
instruction is the PSW. Conditional assembler directives have been generated 
to take this possibility into account. If you know the operand is the PSW, you 
can substitute the appropriate mapping from Appendix A for: 

• POP PSW (Using EXACT Control) 

• POP PSW (Using APPROX Control) 

• PUSH PSW (Using EXACT Control) 

• PUSH PSW (Using APPROX Control) 

On the other hand, if you know the operand is definitely not the PSW, you can 
substitute the appropriate mapping from Appendix A for: 

• POP rw (Using either EXACT or APPROX) 

• PUSH rw (Using either EXACT or APPROX) 

If you cannot determine whether the operand is the PSW, you should desk- 
check or single-step your source program until you are able to make that deter- 
mination. Otherwise, the conditional assembly statements placed by CONV86 
in your OUTPUT file will not assemble under version V2.0 of the MCS-86 
Macro Assembler. 

30 UNKNOWN INSTRUCTION ASSUMED TO BE A MACRO 

The converter is unable to recognize this statement and has assumed that it is a 
macro call. You should verify this assumption and recode if necessary. 

31 GENERATED LABEL MIGHT NEED TO BE DECLARED LOCAL 

The converter has generated a label within a macro definition. This label must 
be made local if the macro is invoked more than once. 

32 (NO)COND CONTROL DELETED 

No corresponding control exists for the 8086 assembler. No manual editing is 
required for this caution. 

33 (NO)MACRODEBUG CONTROL DELETED 

No corresponding control exists for the 8086 assembler. No manual editing is 
required for this caution. 

34 METACHARACTER OR PARENTHESIS FOUND IN IRPC STRING 

A '%,' '(' or ')' character was left in an IRPC string but will not be correctly 
interpreted by the 8086 assembler. This requires your attention. 
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35 EXPRESSION ASSUMED TO BE A CONSTANT 

CONV86 has not been able to determine what type of expression is in this 
instruction. CONV86 has assumed that the expression is a numeric constant. If 
this assumption is incorrect, you should examine the resulting 8086 statement 
and recode the mapped expression to suit your intent. You may find it helpful to 
insert additional labels. 

36 SYMBOLIC EXPRESSION MAY BE CONTEXTUALLY INVALID FOR ASM86 

A symbolic expression has been encountered in a context in which the 8086 
assembler allows expressions containing only two type of operands: 

a. Numeric constants, and 

b. Macro symbols (preceded or followed by a '%') that evaluate to numeric 
constants. 

If the expression contains symbols which do not conform to b, above, they must 
be replaced by their numeric values or redefined via the % SET macro. 



3-13 




APPENDIX A 
INSTRUCTION MAPPING 



Following are instruction mappings from 8080/8085 to 8086 assembly language. 
Operands are mapped according to Appendix B. Operand designations are as 
follows: 



ib = byte immediate 
iw = word immediate 
mb = byte memory 
mw = word memory 



mn = near memory 
rb = byte register 
rw = word register 



Similarly, ib' refers to the mapping of ib, iw' refers to the mapping of iw, and so on. 
Thus, if B = rb, then rb' = CH. But if B = rw, then rw' = CX. 

Constructs of the form L n are generated internally by CONV86 for use as labels in 

mappings of conditional CALLs, conditional RETurns, conditional JMPs. 



8080/8085 


8086 


Remarks 


AClib 


ADCAL.ib' 




ADCrb 


ADCAL.rb' 




ADDrb 


ADDAL.rb' 




ADIib 


ADDAL.ib' 




ANArb 


ANDAL.rb' 




ANIrb 


ANDAL.ib' 




CALLmn 


CALLmn' 




CCmn 


JNB SHORT L_n 
CALL mn' 


(1 n inserted as label for 

instruction following CALL) 


CMmn 


JNS SHORT L_n 
CALLmn' 


(1 n inserted as label for 

instruction following CALL) 


CMA 


NOTAL 




CMC 


CMC 




CMPrb 


CMPAL.rb' 




CNCmn 


JNAE SHORT L_n 
CALLmn' 


(1 n inserted as label for 

instruction following CALL) 


CNZmn 


JZ SHORT L_n 
CALLmn' 


(1 n inserted as label for 

instruction following CALL) 


CPmn 


JS SHORT L_n 
CALLmn' 


(1 n inserted as label for 

instruction following CALL) 


CPEmn 


JNP SHORT L_n 
CALLmn' 


(1 n inserted as label for 

instruction following CALL) 


CPlib 


CMPAL.ib' 




CPOmn 


JP SHORT L_n 
CALLmn' 


(1 n inserted as label for 

instruction following CALL) 


CZmn 


JNZ SHORT L_n 
CALLmn' 


(1 n inserted as label for 

instruction following CALL) 
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8080/8085 


8086 


Remarks 


DAA 


DAA 




DADrw 


ADD BX,rw' 


(Using APPROX Control) 


DADrw 


LAHF 

ADD BX,rw' 
RCRSM 
SAHF 
RCLSI.1 


(Using EXACT Control) 


DCRrb 


DEC rb' 




DCXrw 


DEC rw' 


(Using APPROX Control) 


DCXrw 


LAHF 
DEC rw' 
SAHF 


(Using EXACT Control) 


Dl 


CLI 




El 


STI 




HLT 


HLT 




IN ib 


INAL, ib' 




INRrb 


INCrb' 




INXrw 


INCrw' 


(Using APPROX Control) 


INXrw 


LAHF 
INC rw' 
SAHF 


(Using EXACT Control) 
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8080/8085 


8086 


Remarks 


JCmn 


JBSHORTmn' 


(For forward short branch) 


JC mn 


JBmn' 


(For backward short branch) 


JCmn 


JAE SHORT L_n 
JMPmn' 


(Otherwise) 


JM mn 


JS SHORT mn' 


(For forward short branch) 


JM mn 


JSmn' 


(For backward short branch) 


JM mn 


JNS SHORT 1 n 

JMPmn' 


(Otherwise) 


JMPmn 


JMP SHORT mn' 


(For forward short branch) 


JMPmn 


JMPmn' 


(Otherwise) 


JNCmn 


JAE SHORT mn' 


(For forward short branch) 


JNCmn 


JAE mn' 


(For backward short branch) 


JNCmn 


JNAE SHORT L_n 
JMPmn' 


(Otherwise) 


JNZmn 


JNZ SHORT mn' 


(For forward short branch) 


JNZmn 


JNZmn' 


(For backward short branch) 


JNZmn 


JZ SHORT L_n 
JMPmn' 


(Otherwise) 


JPmn 


JNS SHORT mn' 


(For forward short branch) 


JPmn 


JNSmn' 


(For backward short branch) 


JPmn 


JS SHORT L_n 
JMPmn' 


(Otherwise) 


JPEmn 


JP SHORT mn' 


(For forward short branch) 


JPEmn 


JP mn' 


(For backward short branch) 


JPEmn 


JNP SHORT L_n 
JMPmn' 


(Otherwise) 


JPOmn 


JNP SHORT mn' 


(For forward short branch) 


JPOmn 


JNPmn' 


(For backward short branch) 


JPOmn 


JP SHORT L_n 
JMPmn' 


(Otherwise) 


JZmn 


JZ SHORT mn' 


(For forward short branch) 


JZmn 


JZ mn' 


(For backward short branch) 


JZ mn 


JNZ SHORT 1 n 

JMPmn' 


(Otherwise) 
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Instruction Mapping 



CONV86 



8080/8085 


8086 


Remarks 


LDAmb 


MOVAL.mb' 




LDAX rw 


MOVSI.rw' 
LODS DS:M[SI] 




LHLDmw 


MOV BX.mw' 




LXI rw,iw 


MOVrw'.iw' 


(When 2nd operand immed. or near) 


LXI rw,iw 


LEArw'.iw' 


(When 2nd operand is byte or word) 


MOVrb1,rb2 


MOVrb1',rb2' 




MOV M, rb 


MOVM[BX],rb' 




MVIrb.ib 


MOVrb'.ib' 




MVIM.ib 


MOVM[BX], ib' 




NOP 


NOP 


XCHG AX.AX (1 byte, 3 clocks) 


ORArb 


ORAL.rb' 




ORlib 


ORAL.ib' 




OUTib 


OUTib',AL 




PCHL 


JMPBX 




POPrw 


POPrw' 


(For EXACT or APPROX when rw is 
definitely not PSW) 


POP PSW 


POP AX 
XCHG AL, AH 


(Using APPROX Control) 


POP PSW 


POP AX 
XCHG AL, AH 
SAHF 


(Using EXACT Control) 


POPrw 


%IF(%EQS 

(rw',AX))THEN( 
POP rw' 
XCHG AL, AH 
)ELSE( 
POP rw' 
)FI 


(Using APPROX when rw 
could be PSW) 


POPrw 


%IF(%EQS 

(rw',AX))THEN( 
POP rw' 
XCHG AL, AH 
SAHF 
)ELSE( 
POP rw' 
)FI 


(Using EXACT Control when rw 
could be PSW) 
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CONV86 



Instruction Mapping 



8080/8085 


8086 


Remarks 


PUSH rw 


PUSH rw' 


(For EXACT or APPROX when rw is 
definitely not PSW) 


PUSH PSW 


LAHF 

XCHG AL, AH 
PUSH AX 
XCHG AL, AH 


(Using EXACT Control) 


PUSH PSW 


XCHG AL, AH 
PUSH AX 
XCHG AL, AH 


(Using APPROX Control) 


PUSH rw 


%IF(%EQS 

(rw',AX))THEN( 
XCHG AL, AH 
PUSH rw' 
XCHG AL, AH 
)ELSE( 
PUSH rw' 
)FI 


(Using APPROX Control when rw 
could be PSW) 


PUSH rw 


%IF(%EQS 

(rw',AX))THEN( 
LAHF 

XCHG AL, AH 
PUSH rw' 
XCHG AL, AH 
)ELSE( 
PUSH rw' 
)FI 


(Using EXACT Control when rw 
could be PSW) 


RAL 


RCLAL.1 




RAR 


RCRAL.1 




RC 


JNB SHORT L_n 
RET 


(I n inserted as label for 

instruction following RET) 


RET 


RET 




RIM 


***error*** 




RLC 


ROLAL.1 




RM 


JNS SHORT L_n 
RET 


(I n inserted as label for 

instruction following RET) 


RNC 


JNAE SHORT L_n 
RET 


(I n inserted as label for 

instruction following RET) 


RNZ 


JZ SHORT L_n 
RET 


(I n inserted as label for 

instruction following RET) 


RP 


JS SHORT L_n 
RET 


(I n inserted as label for 

instruction following RET) 


RPE 


JNP SHORT L_n 
RET 


(I n inserted as label for 

instruction following RET) 


RPO 


JP SHORT L_n 
RET 


(I n inserted as label for 

instruction following RET) 


RRC 


ROR AL,1 




RSTib 


INTib' 




RZ 


JNZ SHORT L_n 
RET 


(I n inserted as label for 

instruction following RET) 
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Instruction Mapping 



CONV86 



8080/8085 


8086 


Remarks 


SBBrb 


SBBAL.rb' 




SBlib 


SBBAL.ib' 




SHLDmw 


MOVmw'.BX 




SIM 


***error*** 




SPHL 


MOVSP.BX 




STAmb 


MOVmb'.AL 




STAX rw 


MOVDI.rw' 
MOVDS:[DI],AL 




STC 


STC 




SUBrb 


SUBAL.rb' 




SUlib 


SUBAL.ib' 




XCHG 


XCHG BX,DX 




XRArb 


XORAL.rb' 




XRlib 


XORAL.ib' 




XTHL 


POP SI 
XCHG BX.SI 
PUSH SI 




unknown expr 


unknown' expr' 
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APPENDIX B 
CONVERSION OF EXPRESSIONS 

IN CONTEXT 



The following describes how 8080/8085 expressions are converted to 8086 expres- 
sions according to the context in which an operand or expression occurs. 
The context is simply what CONV86 infers from the use of the operand in the 
instruction: 

ib = byte immediate 

iw = word immediate 

mb = byte memory 

mw = word memory 

mn = near memory 

rb = byte register 

rw = word register 

M is defined to be a byte located at absolute location 0. In contexts 3 and 5 below, 
forward-referenced memory items are treated as "unknown." 

1 . Context = ib 

• Operand = ib: expr -* expr' 

• Operand = iw: expr -*• LOW(expr') 

• Operand = mn, mw, mb, or unknown: ' 2 
If REL control, then 

expr - LOW DGROUP:(expr') 
If ABS control, then 
expr -* LOW(expr') 

2. Context = iw 

• Operand = ib or iw: expr -*■ expr' 

• Operand = mb, mw, mn, or unknown 2 : 
If REL control, then 

expr - OFFSET DGROUP:(expr') 
If ABS control, then 
expr -* OFFSET(expr') 

3. Context = mb 

• Operand = mb: expr -*> expr' 

• Operand = mn or mw or unknown: expr -*■ BYTE PTR(expr') 

• Operand = ib or iw: expr-* M[expr'] 

4. Context = mn 

• Operand = mn: expr -*- expr' 

• Operand = mb or mw or unknown: expr -*• NEAR PTR(expr') 

• Operand = ib or iw : expr -* NEAR PTR M [expr ' ] 

5. Context = mw 

• Operand = mw: expr -*• expr' 

• Operand = mb or mn or unknown: expr -* WORD PTR(expr') 

• Operand = ib or iw: expr -» WORD PTR M[expr'] 



1 . mn, mw, and mb are illegal in 8080 in this context, but give an implicit LOW. 

2. unknown generates Caution Message 17. 
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Conversion of Expressions in Context 



CONV86 



Context = rb 

• Operand = rb: 

• A^AL 

• B-*CH 

• C-CL 

• D-DH 

• E - DL 

• H -* BH 

• L-BL 

• Operand = mb:M -* M[BX] 
Context = rw 

• Operand = rw: 

• B-CX 

• D-*DX 

• H->BX 

• SP — SP 

• PSW-AX 
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APPENDIX C 
ASSEMBLER DIRECTIVES MAPPING 



This appendix shows how 8080/8085 assembler directives are converted by CONV86 
into 8086 assembler directives. Expression mapping is described in Appendix B. 
Context symbols (for instance, "expr", "mn", and so on) used as directive 
operands are mapped according to Appendix B. 

In certain cases (EQU, IRP, macro call, and SET), it is possible to determine that an 
assignment is being made to a byte or word register. In such cases, the appropriate 
rb or rw expression conversion is performed. The STKLN expression is converted in 
the prologue (see Chapter 1, "Functional Mapping"). 

Table C-l . Assembler Directives Mapping 



8080/8085 


8086 


NOTES 


ASEG 


prev-seg ENDS 

ABS_0 SEGMENT BYTE AT 




CSEG 


prev-seg ENDS 

CODE SEGMENT WORD PUBLIC 'CODE' 




DB expr-list 


DB expr-list' 


DS expr 


DBexpr'DUP(?) 


DSEG 


prev-seg ENDS 

DATA SEGMENT WORD PUBLIC 'DATA' 


DW expr-list 


DW expr-list' 


END[mn] 


prev-seg ENDS 
END[mn'] 


name EQU expr 


name' EQU expr' 


EXTRN name-list 


EXTRN name:usage-list' 


NAME name 


NAME name' 


ORGmn 


ORG mn' 


PUBLIC name-list 


PUBLIC name-list' 


STKLN expr 


'"deleted*** 


If the REL control (a default) is 
used, STKLN converts to informa- 
tion in the prologue. Refer to 
Chapter 1, "Functional Mapping." 


aSETb 


%SET(a',b') 


If the symbol being defined is 
never set to a non-constant. 


PURGE a' 
a' EQU b' 


If the symbol being defined is ever 
set to a non-constant and the SET 
is not self-relative. 


T_a' EQU b' 
PURGE a' 

a' EQU T_a' 
PURGE T_a' 


If the symbol being defined is ever 
set to a non-constant and the set 
is self-relative, e.g., XSETX + 5. 


IF a 


%IF(a')THEN( 




ELSE 


)ELSE( 




ENDIF 


)FI 
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Assembler Directives Mapping 



CONV86 



Table C-l . Assembler Directives Mapping (Cont'd.) 



8080/8085 


8086 


NOTES 


a MACRO b,... 


%*DEFINE(a'(b',...)) 
LOCAL c'...( 


All local labels for the macro (c'...) 
are moved to the local list in the 
macro definition, with blanks 
replacing commas. LOCAL 
statements disappear. The word 
LOCAL is not produced if there are 
no local labels. 

The parentheses around b',... are 
omitted when the parameter list is 
null. 


LOCAL c, ... 


none 




ENDM 


) 


If this directive closes a macro. 


)) 


If this directive closes a REPT, IRP 
or IRPC definition. 


mcall b, ... 


%mcall(b',...) 


The parentheses are omitted 
when the parameter list is null. 


IRPa.b 


%IRP(a',b')c'...(%( 


All local labels for the macro (c'...) 
are moved to the local list in the 
macro definition, with blanks 
replacing commas. LOCAL 
statements disappear. 


IRPCa.b 


%IRPC(a',b')c'...(%( 


All local labels for the macro (c'...) 
are moved to the local list in the 
macro definition, with blanks 
replacing commas. LOCAL 
statements disappear. 


REPTa 


%REPT(a')c'...(%( 


All local labels for the macro (c'...) 
are moved to the local list in the 
macro definition, with blanks 
replacing commas. LOCAL 
statements disappear. 


EXITM 


%EXIT 
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APPENDIX D 
RESERVED NAMES 



A name appearing in an 8080/8085 expression may have a special 8086 interpreta- 
tion (for instance, AL or TEST), or it may be reserved for a segment or group name 
(for instance, CODE). Except for STACK, which is converted to STACK_BASE, 
each such name is automatically converted by CONV86 by appending an underscore 
to it (for instance, AL_ or TEST_). The 8080 reserved word MEMORY is treated 
specially. 

The following ASM86 reserved names are modified by CONV86: 

Table D-l . Reserved Names 



AAA 


CX 


IDIV 


JNO 


NEAR 


ROL 


AAD 


DAS 


IMUL 


JNP 


NEG 


SAHF 


AAM 


DD 


INC 


JNS 


NES 


SAL 


AAS 


DEC 


INCHAR 


JO 


NIL 


SAR 


ABS 


DEFINE 


INT 


JS 


NOSEGFIX 


SCAS 


AH 


DH 


INTO 


LABEL 


NOTHING 


SEG 


AL 


DIV 


IRET 


LAHF 


OFFSET 


SEGFIX 


ASSUME 


DL 


JA 


LDS 


PARA 


SEGMENT 


AT 


DUP 


JAE 


LEA 


POPF 


SHORT 


AX 


DWORD 


JB 


LEN 


PREFX 


SI 


BH 


DX 


JBE 


LENGTH 


PROC 


SIZE 


BL 


ELSE 


JCXZ 


LES 


PROCLEN 


SS 


BP 


ELSEIF 


JE 


LOCK 


PIR 


STD 


BX 


END1F 


JG 


LODS 


PURGE 


STI 


BYTE 


ENDM 


JGE 


LOOP 


PUSHF 


STOS 


CBW 


ENDP 


JL 


LOOPE 


RCL 


STRUC 


CH 


ENDS 


JLE 


LOOPNE 


RCR 


SUBSTR 


CL 


EQS 


JNA 


LOOPNZ 


RECORD 


TEST 


CLC 


ES 


JNAE 


LOOPZ 


RELB 


THIS 


CLD 


ESC 


JNR 


LTS 


RELW 


TYPE 


CLI 


EVAL 


JNBE 


MASK 


REP 


WAIT 


CMPS 


EXIT 


JNE 


MATCH 


REPE 


WHILE 


CODEMARCO 


FAR 


JNG 


METACHAR 


REPEAT 


WIDTH 


COMMON 


GES 


JNGE 


MODRM 


REPNE 


WORD 


CS 


GROUP 


JNL 


MOVS 


REPNZ 


XLAT 


CWD 


GTS 


JNLE 


MUL 


REPZ 





The names CGROUP, CODE, CONST, DATA, and DGROUP are reserved by 
CONV86 to set up a PL/M-86 environment. 

The assembler-reserved symbols ? and ??SEG are not permitted as user mnemonics. 
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APPENDIX E 
MACRO CONSTRUCT CONVERSION 



All macro definitions and calls will be translated to their 8086 macro processing 
language equivalents. However, macro related constructs require special conversion. 

The following 8080/8085 macro constructs are converted to their 8086 equivalent as 
shown: 



Table E-l . Macro Construct Conversion 



8080 
CONSTRUCT 


8086 
EQUIVALENT 


NOTES 


;; 


%' 


Within a macro definition body. 


! 


%1 


When quoted or within a list or IRPC string. 


NUL operand 


% EQS(operand ' , %0) 


Within any expression. 


<list> 


%(list') 


Within any macro argument field, but '< >' is 
stripped when surrounding an IRPC string. 


( 


%1( 


Within < > or ' ' in macro call parameter, 
macro definition, IF expression or body, or 
SET body. 


) 


%1) 


Within < > or ' ' in macro call parameter, 
macro definition, IF expression or body, or 
SET body. 


%expression 


expression' 


Within macro argument field. 


symbol 


%(symbol') 


When symbol is a macro parameter and is 
being passed to another macro in an argu- 
ment field that does not use %. 


symbol 


%symbol' 


When symbol is a parameter or local symbol 
in a macro definition, a macro itself, or 
defined with a SET directive. 


% 


%1% 


Within quotes when not causing 
concatenation. 


& 


% 


Concatenation translation. 
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APPENDIX F 

SAMPLE CONVERSION 

AND LISTINGS 



This appendix consists of: 

• Figure F-l . 8080 Sort Routine Source File 

• Figure F-2 . CON V86 PRINT File of Conversion of 8080 Sort Routine 

• Figure F-3. MCS-86 Macro Assembler Listing of Conversion of 8080 Sort 
Routine 

• Figure F-4. MCS-86 Macro Assembler Listing of Originally Coded 8086 Sort 
Routine 

Please note that the CONV86 OUTPUT file was edited before submitting it to 
ASM86 for assembly. The OUTPUT file was edited as follows: 

1 . To retrieve PL/M-86 stack parameters, code (corresponding to lines 44-47 in 
Figure F-3) was inserted as described in Chapter 3. 

2. To correct incomplete register mapping due to mnemonics appearing in an 
IRPC string, IRPC calls have been deleted at lines 69 and 85 in Figure F-2, and 
the code has been expanded by hand to that at lines 91-94 and 132-133 in Figure 
F-3. This edit is in response to the converter generated caution. 

3. For space/ time considerations, only the necessary LAHF/SAHF instructions 
were retained from the OUTPUT file. Since the file was converted using the 
(default) control EXACT, flag-preserving code for all occurrences of DAD, 
DCX, INX, and PUSH/POP PSW was generated. You can determine which 
flag-preserving code has been retained by comparing Figures F-2 and F-3 
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Sample Conversion & Listings 



CONV86 



MACROFI^El :F1r) NOOBJSCT 

ttlllllOIIIltltlllililiiitXllXilliilllltlillillllltllt 

A PL/M caLlabLe subroutine: 

CALi. SOfiTl .A1..N) 
Sorts the array A1, containing M words. 
At entry BC points to the array A1, and 
DS points to N. Two pointers to eleaents of A1 are 
incremented in two Loops. The outer Loop 3teps DS 
through the elements of A1. The inner Loop steps 
flj through the elements of A1 that folLow DE. At 
each step of the inner Loop, the items at Hi. and DE 
are exchanged, if required, so that at the end of 
the inner Loop, the itea at DS is Larger tha aLL 
the items that foLLow it. The item at 02 is then in 
its proper position, so DE is ins? eaented to 
compLete one iteration of the outer Loop. 

flHIIIHlllilllllMllllillllllilllllllllllllllliiaiMJll 

Data area foLLows 
DSE3 
EST: DS 2 

Begin oode area 
CSEG 

PUBLIC SORT 
WAP MACRO 

; This macro swaps two bytes pointed to by H\. and DE. 
LDAX D 

MOV C,M 

MOV M,A 

XCH3 

MOV M,C 

XCHG 
3NDM 



- 1 ) 



Test 


ad 


iress of t 


he 


Last eLement 


ORT: 




XCH-3 
MOV 
I NX 
MOV 
XCHG 
OCX 
DAD 
DAD 
SH^O 




; TEST = : ii - 
■3.M 
H 
D.M 

H 
H 

8 

TEST 



Figure F- 1 A. 8080 Sort Routine Source File 
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CONV86 



Sample Conversion & Listings 



OUTER vOOPr DO DE = .A1 TO TEST BY 2; 

MOV E.C 

MOV D,B 

irrST: '..DA TEST 

SUB S 

'.DA TEST *■ 1 

SBB D 
RC 

INNER LOOP:- DO Hi. = DE + 2 TO TEST B!f 2 

MOV U.fi 

MOV H.D 

REPT Z 

INX 
SNDM 



; BC CONTAINS .A1 

; IF 03 > TEST THEN RETURN 



H 



;Ht. = D£ «■ 2 



; IF HL > TEST THEN SOTO OUTISC 
INTSTj- UDA TEST 

SUB \ 

'..DA TEST * 1 

SBB H 

JC OUTINC 
; IF A1IHL) < A1IDE) THEN GOTO ININC 
; As a side effeat. Hi. and DE ace inoreaented by 1 
; bo point to the nigh byte3 of their aCi'ay elements. 

•.DAK D 

SUB M 

IRPC Z.DH 

INX Z 

ENDM 

LDAX D 

SBB M 

JNC INIMC 



Figure F-1B. 8080 Sort Routine Source File 
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Sample Conversion & Listings CONV86 



; exchange AIDS) with Al Hii ) . '^eavs Hj arid DS 
; pointing to HIGH bytes. 

SWAP 

IRP Z,<D,H> 

OCX Z ;; Put IZ) and H in their' DLaoe 

SNDM 
; Exchange Low bytes 

SWAP 
; Point H., and DS to high bytes 
ISPC Z.DH 

ISX Z 

ehdm 

; DE an H'j point to HIGH bytes. Foi* the next iteration, 
; set DS = Previous DS. HU = 2 «■ Previous HU . 
IMINC: DCX D 

rax a 
jmp rarsr 

; 2nd of outer Loop. Set DS = DS -i- 2 
OUTINC: REPT 2 

IMX 

SNDM 

JMP 'J r T 3 T 

END 



Figure F- 1 C . 8080 Sort Routine Source File 
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CONV86 



Sample Conversion & Listings 



ASM30 TO ASM35 CONVERTER 



ISIS-II ASM30 TO A3M3S CONVERSION Of FILE 
ASM36 PLACED IN : F 1 : SORTS . A86 
CONVERTER V2.0 INVOKED BY." 
:>F1:CONV85 :F1rS0RT30 N0S0URCELI3T 



8086 PROGRAM 



$ WORK 
CGROUP 
DGROUP 

CONST 

CONST 

STACK 

STACK_ 

STACK 

MEMORY 

MEMORY. 

MEMORY 

ABS_0 

M 

J»DEFI 



t'DEFI 



FILESl :F1 
GROUP 
GROUP 
ASSUME 
SEGMENT 
ENDS 
SEGMENT 

BASE 
ENDS 
SEGMENT 

_ LABEL 
ENDS 
SEGMENT 
LABEL 

NE IREPT 
J»DEFIN 
JREPEAT 

NE I IRP I 
J»DEFIN 
j&»DSFIN 
*IF It'u 



:,;F1:) NOOBJECT 
ABS_0, CODE, CONST, DAT A. STACK, MEMORY 
ABS_0, CODE, CONST, DAT A. STACK, MEMORY 
DS:DGR0UP,CS: CGROUP, SS:>DG ROUP 
WORD PUBLIC ' CONST* 

WORD STACK 'STACK* 
LABEL BYTE 

WORD MEMORY * MEMORY' 
BYTE 

BYTE AT 

BYTE 
IN) LOCALS I BODY)) LOCAL MACRO I 
E I MACRO) LOCAL ^LOCALS ItBODY) 

US) ItMACRO) ) 
PARM.PLIST) LOCALS IBODY)) LOCAL MACRO LIST I 
E I MACRO) LOCAL JLOCALS IJBODY) 
E ILIST) IJPLIST) 
ENIJ*LIST) SQ 0) THEN I 

JDEFINE IJPARM) 110) 

JMACRO ) 



FI ) 
$*DEFINE I IRPC 
*»DEFIN 
it«DEFIN 
JIF !JL 



ELSE I 





FI ) 


2 


»*»»*»»*« *»!*• 


3 


A PL/M oallab 


4 


C 


5 


Sorts the arr 


6 


At entcy BC p 


7 


DE points to 


3 


■ incremented i 


9 


through the e 



JWHILE IJLENI J*LIST) NE 0) I 

JMATCHI*.PARM,LIST) I**LIST) 
jtMACRO ) ) 

IPARM.TEXT) LOCALS IBODY)) LOCAL MACRO LIST I 
E I MACRO) LOCAL JLOCALS IJBODY) 
E ILIST) IJETEXT) 
ENl*>»LIST) EQ 0) THEN I 

*DEFINE 1JPARM) I jtO ) 

•JMACRO ) 

JWHILE IJLENI?*LIST) NE 0) I 

/.DEFINE 1JPARM) I T.»SUBSTRl J«LIST. 1, 1 ) ) 
JDEFINE ILIST) I **SUBSTRl **L 1ST, 2 , 9999 ) ) 
JtMACRO ) ) 

le subroutine: 

ALL S0RTI.A1.-N) 

ay A1 , containing N words. 

oints to the array A1, and 

N. Two pointers to elements of A1 are 

n two Loops. The outer Loop steps DE 

Lements of A1. The inner loop steps 



Figure F-2A. CONV86 PRINT File Conversion of 8080 Sort Routine 
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Sample Conversion & Listings 



CONV86 



ASM30 TO ASM86 CONVERTER 



10 
1 1 
12 
13 
1U 
15 
16 
17 
18 
19 
19 
20 
21 
22 
22 
23 
24 
25 
26 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
36 
36 
37 
38 
39 
39 
39 
40 
40 
40 
40 
40 
41 
41 
41 
41 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
50 



Hi. through the elements of A1 that follow DE. At 
each step of the Inner Loop, the Items at HU and DE 
are exchanged, if required, 30 that at the end of 
the inner loop, the Item at DE is larger tha all 
the items that foLlow it. The item at DE is then in 
its proper position, so DE is incremented to 
complete one iteration of the outer loop. 

lillDllllltlllHIMIIIXIliilllllllilllKillllillllllllll 

Data area foLlows 
ABS_0 ENDS 

DATA SEGMENT WORD PUBLIC 'DATA' 
TEST_ DB 2 DUP I?) 
; Begin code area 
DATA ENDS 
CODE SEGMENT WORD PUBLIC 'CODE* 

PUBLIC SORT 
^•DEFINE I SWAP) I 
t* This macro swaps two bytes pointed to by HL and DE. 

MOV SI.DX 

L0DS DSs-MlSI] 

MOV C!.,M:BX] 

MOV MlBX],AL 

XCHG BX.DX 

MOV MlBX],CU 

XCHG 6X.DX 

) 
address of the last element of A1. 



; Test 

SORT: XCHG 
MOV 
LAHF 
INC 
SAHF 
MOV 
XCHG 
LAHF 
DSC 
SAHF 
LAHF 
ADD 
RCR 
SAHF 
RCL 
LAHF 
ADD 
RCR 
SAHF 
RCL 
MOV 

? OUTER LOOP: 
MOV 
MOV 

0UTTST> MOV 
SUB 
MOV 
SBB 
JNB 
RET 



BX.DX 
DL.Mf BX] 



DH.MlBX] 
BX.DX 



BX.BX 
SI,1 

SI, 1 

BX.CX 
SI.1 

SI. 1 

WORD PTRlTEST_) ,BX 

DO DE = .A1 TO TEST BI 2 

DL , CL 

DH.CH 

AL,TEST_ 

AL.DL 

AL,TEST_)-1 

Ai. , DH 

SHORT L_1 



TEST = iH - I) ' 2 f .A1 



IN 



- 1) 



BC CONTAINS .A1 



IF DE > TEST THEN RETURN 



Figure F-2B. CONV86 PRINT File Conversion of 8080 Sort Routine 
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CONV86 Sample Conversion & Listings 



ASM80 TO ASM86 CONVERTER 

5 L_1: 

51 ; INNER LOOP? DO HL = tfE+2 TO TEST BI 2 

52 MOV BL.DL 

53 MOV BH.DH 

54 JREPT 12) 1*1 

55 LAHF 

55 INC BX 

55 SAHF 

56 )) 

57 ;HL = DE + 2 

58 ; IF Hi. > TEST THEN GOTO OUTINC 

59 INTST: MOV AL,TEST_ 

60 SOB Ai.BL 

61 MOV AL,TEST_+1 

62 SBB AL.BH 

63 JB SHORT OUTINC 

64 ; IF A1lHL) < A1IDE) THEN GOTO ININC 

65 ; As a side affect, HL and DE ace iner emented by 1 

66 ; to point to the nigh bytes of their array elements. 

67 MOV SI.DX 

67 LODS DS:MrSI] 

68 SUB AL.MlBX] 

69 JIRPC 1Z,DH) HI 

»»» CAUTION 002 »** 8030 REGISTER MNEMONIC APPEARING IN IRPC STRING 

70 LAHF 

70 INC %Z 

70 SAHF 

71 )) 

72 MOV SI.DX 

72 LODS DS:M>SI] 

13 SBB AL.MlBX] 

n JAE SHORT ININC 

75 ; Exchange AIDE) with A! Hi. ) . Leave Hi and DE 

76 ; pointing to HIGH bytes. 
7 7 JSWAP 

78 JIRP IZ.JlDX.BX)) I»I 

79 LAHF 

79 DEC %Z 

79 SAHF $' Put IZ) D and H in their place 

80 )) 

81 ; Exchange low bytes 

82 ; 

83 JSWAP 

84 ; Point HL and DE to high bytes 

85 JIRPC IZ.DH) HI 

•■• CAUTION 002 •»■ 8080 REGISTER MNEMONIC APPEARING IN IRPC STRING 

86 LAHF 

86 INC JZ 

86 SAHF 

87 )) 

89 ; DE an HL point to HIGH bytes. For the next iteration, 

89 ; set DE = Previous DE, HL = 2 (■ Previous HL. 

90 ININC: LAHF 

90 DEC DX 

90 SAHF 

91 LAHF 

91 INC BX 



Figure F-2C. CONV86 PRINT File Conversion of 8080 Sort Routine 
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Sample Conversion & Listings CONV86 



ASM80 TO ASM86 C0NV3RTER 



91 SAHF 

92 JMP INTST 

93 ; End of outer loop. Set DE = DE + 2 

94 OUTINC: JREPT 12) III 



95 




LAHF 




95 




INC 


OX 


95 




SAHF 




96 




)) 




97 




JMP 


OUTTST 


98 CODE 




ENDS 




98 




END 




2 CAUTION! S) 








END OF ASM80 


TO 


ASM86 


CONVERSION 



Figure F-2D. CONV86 PRINT File Conversion of 8080 Sort Routine 
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CONV86 



Sample Conversion & Listings 



MCS-35 MACRO ASSEMBLER 



ISI3-II MCS-36 MACRO ASSEMBLER V2.0 ASSEMBLY 0? MODULE S0RT30 

NO OBJECT MODULE REQUESTED 

ASSEMBLER INVOKED BY: :F3:ASM35 rf 1 : S0RT30 . A35 

LOC OBJ LINE SOURCE 



0000 12 
?? 
) 



0000 

0000 5B 

0001 59 

0002 5A 



1 

2 

3 

4 

5 

5 

7 

8 

9 
10 
1 1 
12 
13 
14 
15 

16 +1 

17 +1 
18 

19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 



38 
39 
40 
41 
42 
43 
44 
45 
46 
47 



$ WORKFILESl:F1:.:F1: ) NOOBJECT 

CGROUP GROUP ABS_0, CODE, CONST, DATA, STACK. MEMORY 

GROUP ABS_0, CODE. CONST, DAT A. STACK. MEMORY 

ASSUME DSr-DGROUP.CS: CGROUP. SS^DGROUP 

SEGMENT WORD PUBLIC 'CONST* 

ENDS 

SEGMENT WORD STACK 'STACK' 
LABEL BYTE 



DGROUP 

CONST 

CONST 

STACK 

STACK_BASE 

STACK ENDS 

MEMORY 

MEMORY. 

MEMORY 

ABS_0 

M 



SEGMENT WORD MEMORY 

LABEL BYTE 

ENDS 

SEGMENT BYTE AT 

LABEL BYTE 



'MEMORY' 



A PL/M oaLLabL 
CA 
Socts the area 
At entry BC po 
DE points to N 
incremented in 
through the el 
Ht, through the 
each step of t 
are exchanged, 
the inner loop 
the items that 
its proper pos 
complete one i 
»*»*»»»* )»••»* i 

Data area fo 
ABS_0 ENDS 
DATA SEGMENT 
TEST DB 



e subroutiner 

LL SORT! .A1..N) 

y A1 , containing N words. 

ints to the array A1, and 

. Two pointers to eLementa of A1 are 

two loops. The outer loop steps DE 
ements of A1. The inner loop steps 

elements of A1 that foLlow DE. At 
he inner loop, the items at HL and DS 

if required, so that at the end of 
, the item at DS is Larger tha aLl 

foLLow it. The item at DE is then in 
ition. so DE is incremented to 
teration of the outer Loop. 
»i»ii»»»»»»«»»»*»«»t*»i»»»»»i*»i*»»*iti»»*«> 

I Lows 



WORD PUBLIC 
2 DUP I?) 



1 DATA' 



; Begin code area 
DATA ENDS 

CODE SEGMENT WORD PUBLIC 'CODE' 
PUBLIC SORT 

; Test = address of the Last eLement of A1. 
SORT: 

POP BX 

POP CX 

POP DX 



? »*«» CODE INSERTED TO 
- »»•* RETRIEVE PL/M-86 
; «»** STACK PARAMETERS 



Figure F-3 A. MCS-86™ Macro Assembler Listing 
of Conversion of 8080 Sort Routine 
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Sample Conversion & Listings 



CONV86 



M S-86 MACHO ASSEMBLER 



SORT80 



uoc 


OBJ 




LINE 




SOURCE 








0003 


53 




K8 








PUSH 


BX ; »*»» ^CHAPTER 3) 


0004 


87DA 




49 








XCHG 


BX.DX ; TEST = 1 N - 1 ) * 2 * . A1 


0006 


8A970000 


R 


50 








MOV 


DS,,M:BX] 


O00A 


43 




51 








INC 


BX 


OOOB 


8AB70000 


R 


52 








MOV 


dh.m:»bx] 


O00F 


87DA 




53 








XCHG 


BX.DX ; !N 


0011 


4B 




54 








DEC 


BX ; - 1 ) 


0012 


03DB 




55 








ADD 


BX.BX 


* 2 


0014 


03D9 




56 








ADD 


BX.CX 


4- .A1 


0016 


891E00OO 


R 


57 








MOV 


WORD PTRI TEST_) ,BX 


= TEST 








58 






3UTER LOOE 


: DO DE = .A1 TO TEST BY 2 




001A 


8AD1 




59 








MOV 


DL , Cu 


BC CONTAINS .A1 


001C 


3AF5 




60 








MOV 


DH.CH 


001E 


AOO000 


R 


61 




OUTTST; 


MOV 


AL,TEST_ ; IF DS > TEST THEN RETURN 


0021 


2AC2 




62 








SUB 


A'.. , DL 


0023 


A00100 


R 


53 








MOV 


AL.TEST_.i-1 


0026 


1AC6 




54 








SBB 


AL.DH 


0028 


7301 




65 








JNB 


SHORT L_1 


002A 


C3 




66 








RET 




002B 






57 




'-_1: 














68 




; INNER 


'..OOP* 


DO HL = DE+2 TO TEST BY 2 


002B 


8ADA 




69 








MOV 


BL.DL 


002D 


8AFE 




70 
M 
72 
13 


+ 1 
+ 2 
+ 3 






MOV 


BH.DH 


O02F 


43 




74 

75 


+ 3 
+ 3 






INC 


BX 


0030 


43 




76 
77 
78 


+ 3 
+ 3 






INC 


BX 

:HU - DE + 2 








79 




; IF 


HI. 


> TEST 


THEN GOTO OUTINC 


0031 


AOOOOO 


R 


80 




INTST> 


MOV 


AL,T£ST_ 


0034 


2AC3 




81 








SUB 


A!. . B\ 


0036 


A00100 


R 


82 








MOV 


AL.TEST_.i-1 


0039 


1AC7 




83 








SBB 


AL.BH 


003B 


7242 




84 








JB 


SHORT OUTINC 








85 




;■ IF 


A 1 1 H!. ) < 


A1IDE) THEN GOTO ININC 








85 




; As 


a 


side effect, HI. and DE are incremented by 1 








87 




; to 


point to 


the nigh bytes of their array elements. 


003D 


8BF2 




88 








MOV 


SI.DX 


O03F 


AC 




89 








LODS 


DS>M>SI] 


0040 


2A870OOO 


R 


90 








SUB 


AL.MlBX] 


0044 


9F 




91 








UAHF 


; »*»* The IRPC invocation reguires manual e 


0045 


42 




92 








INC 


DX ; ***• The LAHF and SAHF exact mapping is re 


0046 


43 




93 








INC 


BX 


0047 


9E 




94 








SAHF 




0048 


3BF2 




95 








MOV 


SI.DX 


004A 


AC 




96 








LODS 


DSi-Ml-SIJ 


004B 


1A870000 


R 


97 








SBB 


AL.M'BX] 


004F 


732A 




98 








JAE 


SHORT ININC 








99 




; Exchange AIDE) with A! HU ) - Leave H<, and DE 








100 




; point 


ing to 


HIGH bytes. 








101 


+ 1 













Figure F-3B. MCS-86™ Macro Assembler Listing 
of Conversion of 8080 Sort Routine 
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CONV86 



Sample Conversion & Listings 



MCS-86 MACRO ASSEMBLER 



SORT30 



loc 


OBJ 




VINE 




SOURCE 






0051 


8BF2 




102 


+ 1 




MOV 


SI.DX 


0053 


AC 




103 


+ 1 




LODS 


DSrM>SI] 


0054 


8A8FOOOO 


R 


104 


+ 1 




MOV 


CL.Ml-BX] 


0058 


88870000 


R 


105 


+ 1 




MOV 


M?BX ] . kl 


005C 


87DA 




106 


♦ 1 




XCHG 


BX.DX 


005E 


888F0OO0 


R 


107 


+ 1 




MOV 


M>BX ] , CL 


0062 


87DA 




108 
109 
110 
111 
112 
113 
114 
115 
116 


+ 1 
+ 1 

+ 2 
+ 2 
+ 2 
+ 4 
+ 4 
+ 4 




XCHG 


BX.DX 


0064 


4A 




117 
118 
119 


+4 
«-4 
+4 




DEC 


DX 


0065 


IB 




120 


♦ 4 




DEC 


BX 








121 




; Exchange low bytes 








122 


*• 1 








0066 


8BF2 




123 


+ 1 




MOV 


SI.DX 


0068 


AC 




124 


+ 1 




LODS 


DS:M:SI] 


0069 


8A8FOOO0 


R 


125 


+ 1 




MOV 


CL.MlBX] 


006D 


88870000 


R 


126 


+ 1 




MOV 


MlBXl.AL 


0071 


87DA 




127 


+ 1 




XCHG 


BX.DX 


0073 


888FOOO0 


R 


123 


♦■1 




MOV 


M?BX],CL 


0077 


87DA 




129 
130 


+ 1 
+ 1 




XCHG 


BX.DX 








131 




; Point 


Hi and 


DE to high bytes 


0079 


12 




132 






INC 


DX 


i t 


IRPC call 


removed 


and 










007A 


43 




133 






INC 


BX 


* »* 


Expanded 


by hand 


















131 




; OS an 


HL point to HIGH bytes. 








135 




; set DE a Previous DE. HL = 2 + 


007B 






136 




ININC: 






007B 


4A 




137 






DEC 


DX 


007C 


43 




138 






INC 


BX 


007D 


EBB2 




139 






JMP 


INTST 








140 




; End o 


f outer 


Loop. Set DE = DE 


007F 






141 
142 
143 


+ 1 
+ 2 
+ 3 


OUTINC: 






007F 


42 




144 
145 


+ 3 
+ 3 




INC 


DX 


0080 


42 




146 
147 


+ 3 
+ 3 




INC 


DX 


0081 


EB9B 




148 






JMP 


OUTTST 


____ 






149 
150 




CODE 


ENDS 
END 





For the next iteration, 
Previous HL. 



ASSEMBLY COMPLETE. NO ERRORS FOUND 



Figure F-3C. MCS-86™ Macro Assembler Listing 
of Conversion of 8080 Sort Routine 
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Sample Conversion & Listings 



CONV86 



MOS-86 macro assembles 



SORT35 



ISIS-II MCS-35 MACRO ASSEMBLER V2.0 ASSEMBLY 0? MODULE SORT35 
OBJECT MODULE PLACED IS : f 1 : SORT35.0BJ 
ASSEMBLER INVOKED BY: :F3:A3M8o :F1:SORT35 



0000 

0006M 

00041] 
0000 55 

001 8BEC 
0003 8B7606 

0006 8B5E04 
0009 8B0F 
000B 03C9 
OOOD 03CE 
OOOF 

OOOF 3BF1 
0011 T31B 

0013 8D7C02 
0016 

0016 3BF9 
0018 HOF 
001A 8B04 

001 C 3 BO 5 
001E 7304 
0020 8705 
0022 8904 
0024 

0024 83C702 
0027 EBED 
0029 



1 
2 
3 
4 
5 
5 
7 
3 
9 
10 
1 1 
12 
13 
14 
15 
16 
W 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 



CODE 

SORT 

A0DR_A1 

ADDR_N 



•**»•*■*»»«••• 

A PL/M oallab 
C 
Sorts the aff 
At entry the 
are on the st 
are kept, in t 
are Increment 
SI through th 
DI through th 
' step of the 
al L the items 
its proper po 
complete one 

»*•* IKtlilill 

CGROUP GROUP 
; No DS ASSUME 
; doesn" t refer 

ASSUME 

SEGMENT 

PUBLIC 

PROC 

EQU 

EQU 

PUSH 

MOV 

MOV 

; Outer 

MOV 

MOV 

ADD 

ADD 

CMP 
JAE 
' loop: 

lea 

CMP 

JAE 

MOV 

CMP 

JNB 

XCHG 

MOV 

ADD 
JMP 



Le subroutine: 
ALL SORTI.A1..N) 
ay A1, containing 
address of N. and 
ack. Two. pointer 
he SI and DI regi 
ed in two loops. 

elements of A1. 
e elements of A1 
nner loop, the it 

that follow it. 
sition, so SI is 
iteration of the 

CODE 
is needed, since 
ence a DATA segme 

( CS>CGROUP 

PUBLIC 'CODE' 

SORT 

NEAR 

WORD PTR lBP+6] 

WORD PTR :BP+4] 

BP 

BP.SP 

SI„ADDR_A1 

loopr DO SI 

BX, ADDR_N 

CX.I'BX] 

CX.CX 

CX. SI 



»»»«»»»»»»»»»»*»«»*»»»>»*« 



N words. 

the address of A1 
s to elements of A1 
sters. These pointers 

The outer loop step3 
The inner loop steps 
that follow SI. At each 
em at SI is larger than 

The item at SI is then in 
incremented to 
outer loop. 

illllllllKillllllllKlilli 



this 
nt. 



•outine 



; first parameter 

; second parameter 

; use BP to accesss parameters 



.A 



1 BY 2 WHILE SI < CX 

CX = N 

» 2 

+ .A1 



SI.CX ; IF SI >= CX THEN RETURN 

EXIT 

DO DI = SI+2 WHILE DI < CX 

DI.I-SI + 2] ;DI = SI + 2 

DI.CX ; IF DI >= CX 

0UTINC ; THEN exit inner loop 

AX.I'SI] ;IF A1>SI] 

AX«>DI] ; < A1IDI] 

ININC 

AX.I'DI] ; THEN EXCHANGE AllDI] 

ISI],AX ; WITH A11SI] 

DI.2 
INTST 



Figure F-4A. MCS-86™ Macro Assembler Listing 

of Originally Coded 8086 Sort Routine 
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CONV86 



Sample Conversion & Listings 



M S-86 MACRO ASSEMBLER 



SORT36 



UOC OBJ 

0029 33C702 
002C EBE1 
002E 
002S 5D 
002F C20400 



ASSEMBLY COMPLETE, NO ERRORS FOUND 



NE 


SOURCE 






50 




ADD 


DI,2 


51 




JMP 


OUTTST 


52 


EXIT." 






53 




POP 


BP 


54 




RET 


1» 


55 


SORT 


ENDP 




56 


CODE 


ENDS 




57 




END 





Figure F-4B. MCS-86™ Macro Assembler Listing 

of Originally Coded 8086 Sort Routine 
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APPENDIX G 

RELOCATION AND LINKAGE 

ERRORS AND WARNINGS 



Because of the way CONV86 sets up multiple segments beginning at absolute 
location (as described in Chapter 1 under "Functional Mapping"), MCS-86 
linkage and relocation tools will issue warnings/errors as shown in Table G-l. You 
can safely ignore these warnings/errors when they specifically apply to intentional 
segment overlap. 



Table G-l . MCS-80™ Relocation and Linkage Warnings/Errors 
for Segment Overlap 



R & L Tool 


Message ID 


Message Text 




WARNING 14 


GROUP ENLARGED 
FILE: filename 
GROUP: groupname 


MCS-86 
LINKER 




MODULE: modname 


WARNING 28 


POSSIBLE OVERLAP 






FILE: filename 






MODULE: modname 






SEGMENT: ABS_0 






CLASS: 



G-l 




INDEX 



ABS control (CONV86), 1-6, 2-3 

absolute addressing, 3-2 

APPROX control (CONV86), 1-11, 2-2 

caution messages, 1-13,3-7 
comments, mapping of, 1-10 
continuation lines, 

in CONV86 command, 2-5 

in PRINT file, 3-1 
controls (ASM80) mapping, C-l 
controls (CONV86), 2-1 
conversions, sample, 1-3, 3-1, F-5 
cross-development (8080/8085- 
to-8086), 1-2 

DATE control (CONV86), 2-2 
directives mapping, C-l 
displaced reference, 3-2, 3-3, 3-10 

EXACT control (CONV86), 1-12, 2-2 
expressions, conversion of, B-l 

files, CONV86, 1-2, 1-13 

files, cross-development, 1-2 

flags, mapping of, 1-9 

flag semantics, 8080-8086 differences, 1-12 

functional equivalence, 1-11 

functional mapping, 1-6 

INCLUDED control (CONV86), 2-3 
instruction mapping, A-l 
instruction queue (8086), 1-11 
interrupts, 3-3 

label insertion by CONV86, 3-2, A-l 
label insertion by user, 3-3 

macro call, 1-3 

macro conversion, 1-3, E-l 

macro definition, 1-3 

MACROFILE control (ASM80), 1-10 

manual editing, 1-3, 1-13, 3-1, F-l 

MOD85 control (ASM80), 1-10 



NOMACROFILE control (ASM80), 1-10 
NOOUTPUT control (CONV86), 2-2 
NOPAGING control (CONV86), 2-2 
NOPRINT control (CONV86), 2-2 
NOSOURCELIST control 

(CONV86), 1-1,2-3 
NOTINCLUDED control (CONV86), 2-3 

operand mapping, B-l 
OUTPUT control (CONV86), 2-2 
overriding controls (CONV86), 2-5 
overriding symbol types, 1-10, 3-9, 
3-10,3-11 

PAGELENGTH control (CONV86), 2-2 
PAGEWIDTH control (CONV86), 2-2 
pipeline (8086), 1-11 
PL/M linkage conventions (8080 & 

8086), 3-6 
PL/M parameter passing (8080 & 

8086), 3-6 
PRINT control (CONV86), 2-2 
PRINT file, sample, 1-4, 3-1 
program listings, 1-5, F-2, F-5, F-9, F-12 
prologues (8086), 1-6 
prompting, 2-5 

register initialization (8086), 3-2 

register mapping, 1-8 

REL control (CONV86), 1-6, 2-3, 3-2, 3-1 1 

relative addressing, 3-2 

relocation & linkage (8086) 

errors/warnings, 1-6, G-l 
requirements for conversion, 1-1, 1-3, 3-1 
reserved names, 1-10, D-l 

SOURCELIST control (CONV86), 1-1,2-3 
stack, CONV86 handling of, 1-8 
stack segment (8086), 1-7 
STKLN directive (8080), 1-7, C-l 
symbol typing, 1-9 

timing delays, software, 1-11 
TITLE control (CONV86), 2-2 

WORKFILES control (ASM80), 1-10 
WORKFILES control (CONV86), 2-3 
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